@wavy/fn 0.0.27 → 0.0.28

package/dist/main.cjs

@@ -56,9 +56,9 @@ __export(main_exports, {
   insertAt: () => insertAt,
   isEmpty: () => isEmpty,
   isFile: () => isFile,
+  isFileDetails: () => isFileDetails,
   isIterable: () => isIterable,
   isLetter: () => isLetter,
-  isLocalFile: () => isLocalFile,
   isNumber: () => isNumber,
   isPromise: () => isPromise,
   lastIndex: () => lastIndex,
@@ -86,8 +86,6 @@ __export(main_exports, {
   removeAll: () => removeAll,
   repeat: () => repeat,
   run: () => run,
-  sanitizeLocalFile: () => sanitizeLocalFile,
-  serverDataAdapter: () => serverDataAdapter,
   someValuesEmpty: () => someValuesEmpty,
   sort: () => sort,
   strictArray: () => strictArray,
@@ -109,13 +107,13 @@ __export(main_exports, {
 module.exports = __toCommonJS(main_exports);
 
 // src/helper-functions/HelperFunctions.ts
-var import_types2 = require("@wavy/types");
+var import_util2 = require("@wavy/util");
 
 // src/helper-functions/components/ObjectConverter.ts
 var import_uuid = require("uuid");
-var import_types = require("@wavy/types");
+var import_util = require("@wavy/util");
 var import_console = require("console");
-function fileToLocalFile(file, options) {
+function fileToFileDetails(file, options) {
   const fileExt = getFileExt(file.name);
   const fileName = (() => {
     if (options?.filename && options.filename.includes(fileExt))
@@ -123,15 +121,17 @@ function fileToLocalFile(file, options) {
     else if (options?.filename) return options.filename.trim() + fileExt;
     return file.name;
   })()?.trim?.();
-  const { name: _, size: __, ..._metadata } = file;
+  const { name: _, size: __ } = file;
   return {
     uid: options?.uid || (0, import_uuid.v4)(),
     description: options?.description,
-    ext: fileExt,
+    extension: fileExt,
     path: options?.filepath || file?.webkitRelativePath,
-    typeAlias: options?.typeAlias || run(
-      Object.keys(import_types.LOCAL_FILE_MIME_TYPES).find(
-        (key) => import_types.LOCAL_FILE_MIME_TYPES[key].includes(file.type)
+    alias: options?.alias || run(
+      Object.keys(import_util.FILE_MIME_TYPES).find(
+        (key) => import_util.FILE_MIME_TYPES[key].includes(
+          file.type
+        )
       ),
       (type) => {
         if (!type) {
@@ -144,23 +144,35 @@ function fileToLocalFile(file, options) {
     sizeInBytes: file.size,
     uploadDate: options?.uploadDate === "now" ? Date.now() : options?.uploadDate ?? file?.lastModified,
     name: fileName,
-    _metadata
+    mime: file.type,
+    lastModified: file.lastModified
   };
 }
-function localFileToFile(localFile) {
+function fileDetailsToFile(details) {
   return {
-    name: localFile.name,
-    size: localFile.sizeInBytes,
-    ...localFile._metadata
+    name: details.name,
+    size: details.sizeInBytes,
+    webkitRelativePath: details.path,
+    lastModified: details.lastModified,
+    type: details.mime,
+    arrayBuffer: null,
+    bytes: null,
+    slice: null,
+    stream: null,
+    text: null
   };
 }
 var Overloader = class {
   invoke(...args) {
     if (isFile(args[0])) {
-      return fileToLocalFile(...args);
+      return fileToFileDetails(
+        ...args
+      );
     }
-    if (isLocalFile(args[0])) {
-      return localFileToFile(...args);
+    if (isFileDetails(args[0])) {
+      return fileDetailsToFile(
+        ...args
+      );
     } else throw new Error(`The arguments supplied are insufficient.`);
   }
 };
@@ -578,12 +590,6 @@ function format(event, ...args) {
       return event;
   }
 }
-function sanitizeLocalFile({
-  _metadata: _,
-  ...file
-}) {
-  return file;
-}
 function isFile(value) {
   const requiredKeys = [
     "name",
@@ -596,25 +602,14 @@ function isFile(value) {
     return true;
   return false;
 }
-function isLocalFile(value) {
-  const dummyLocalFile = {
-    name: "",
-    description: "",
-    path: "",
-    sizeInBytes: 0,
-    ext: "",
-    typeAlias: "unknown",
-    uid: "",
-    uploadDate: 0,
-    _metadata: void 0
-  };
-  const optionalKeys = ["description"];
-  const requiredKeys = Object.keys(dummyLocalFile).filter((key) => !optionalKeys.includes(key));
-  const allKeys = [requiredKeys, optionalKeys].flat();
-  if (value && typeof value === "object" && requiredKeys.every((key) => key in value) && Object.keys(value).every((key) => allKeys.includes(key))) {
+function isFileDetails(value) {
+  try {
+    import_util2.FileDetails.parse(value);
     return true;
+  } catch (error) {
+    console.error(error);
+    return false;
   }
-  return false;
 }
 function isIterable(value) {
   return !!value && typeof value === "object" && Symbol.iterator in value && typeof value[Symbol.iterator] === "function";
@@ -723,7 +718,7 @@ function map(arr, callback) {
   return arr;
 }
 function getMimeTypes(typeAliases) {
-  return distinct(strictArray(typeAliases)).map((alias) => import_types2.LOCAL_FILE_MIME_TYPES[alias]).flat();
+  return distinct(strictArray(typeAliases)).map((alias) => import_util2.FILE_MIME_TYPES[alias]).flat();
 }
 function classNameResolver(baseClassName) {
   return (className) => {
@@ -993,7 +988,7 @@ async function copyToClipboard(text) {
     if (err instanceof Error) {
       return {
         error: {
-          errorCode: "UNKNOWN",
+          code: "UNKNOWN",
           title: err.name,
           message: err.message
         }
@@ -1001,7 +996,7 @@ async function copyToClipboard(text) {
     }
     return {
       error: {
-        errorCode: "UNKNOWN",
+        code: "UNKNOWN",
         title: "Failed to copy text",
         message: JSON.stringify(err)
       }
@@ -1015,7 +1010,7 @@ async function readClipboardText() {
   } catch (err) {
     return {
       error: {
-        errorCode: "UNKNOWN",
+        code: "UNKNOWN",
         title: "Failed to read clipboard contents",
         message: `Something went wrong while trying to read the clipboard contents. [CAUSE]: ${JSON.stringify(
           err
@@ -1027,181 +1022,6 @@ async function readClipboardText() {
 function arrayWithConst(array) {
   return { value: array, asConst: [...array] };
 }
-
-// src/server-adapters/ServerAdapters.ts
-var import_types3 = require("@wavy/types");
-var iiKeys = Object.keys({
-  name: null,
-  address: null
-});
-var stringArrayIdPrefix = "listOf";
-var multiDimArrayIdPrefix = "2DListOf";
-var multiDimArrayDelim = ":";
-var DELIMITERS = {
-  name: " ",
-  address: "|",
-  phoneNumber: " ",
-  stringArray: " "
-};
-var INDEX_MAPPER = {
-  name: { first: 0, last: 1 },
-  address: {
-    streetAddress: 0,
-    city: 1,
-    parish: 2,
-    country: 3
-  }
-};
-function zip(data) {
-  const stringifiedData = JSON.stringify(data);
-  const errorMessage = `Failed to execute [${zip.name}].`;
-  return JSON.parse(stringifiedData, (key, value) => {
-    if (iiKeys.includes(key)) {
-      const validKey = key;
-      const handleTypeMismatchError = (required) => {
-        if (typeof required !== typeof value) {
-          throw new Error(errorMessage, {
-            cause: `[Type Mismatch] Property type {${key}:${JSON.stringify(
-              required
-            )}} is required, but {${key}:${JSON.stringify(
-              value
-            )}} was provided.`
-          });
-        }
-      };
-      switch (validKey) {
-        case "name":
-          handleTypeMismatchError({ first: "", last: "" });
-          break;
-        case "address":
-          handleTypeMismatchError({
-            streetAddress: "",
-            city: "",
-            parish: "",
-            country: "Jamaica"
-          });
-          break;
-        default:
-          return validKey;
-      }
-      let group2 = [];
-      Object.keys(INDEX_MAPPER[validKey]).forEach((prop) => {
-        const validProp = prop;
-        group2[INDEX_MAPPER[validKey][validProp]] = value[validProp]?.trim?.() || "";
-      });
-      return group2.join(DELIMITERS[validKey]).trim();
-    }
-    const valueIsArray = Array.isArray(value);
-    const hasArrayId = key.includes(stringArrayIdPrefix);
-    if (hasArrayId && valueIsArray && strictArray(value).every((v) => typeof v === "string")) {
-      return strictArray(value).join(DELIMITERS.stringArray).trim();
-    } else if (hasArrayId) {
-      throw new Error(errorMessage, {
-        cause: `[Type Mismatch] Every property with the ${stringArrayIdPrefix} prefix, must be an array of strings. However {${key}:${value}} was provided.`
-      });
-    }
-    const hasMultiDimArrayId = key.includes(multiDimArrayIdPrefix);
-    if (hasMultiDimArrayId && valueIsArray && key.includes(multiDimArrayDelim) && value.every(
-      (d) => Array.isArray(d) && d.every((sv) => typeof sv === "object")
-    )) {
-      const mapName = key.split(multiDimArrayDelim)[1];
-      return strictArray(value).map(
-        (objArr) => strictArray(objArr).map((obj) => {
-          if (mapName in obj) {
-            const mapValue = obj[mapName];
-            if (typeof mapValue !== "string") {
-              throw new Error(errorMessage, {
-                cause: `[Type Mismatch] Expected {${mapName}:string} but {${mapName}:${mapValue}} was provided.`
-              });
-            }
-            return mapValue;
-          } else
-            throw new Error(errorMessage, {
-              cause: `[Type Mismatch] Every object in the multi dimensional array must have a property with the name ${mapName}. However ${obj} doesn't adhere to this rule.`
-            });
-        }).join(DELIMITERS.stringArray)
-      );
-    } else if (hasMultiDimArrayId && valueIsArray) {
-      return value.map((arr) => {
-        if (!arr.every((d) => typeof d === "string")) {
-          throw new Error(errorMessage, {
-            cause: `[Type Mismatch] Every sub type of the array must be a string. However ${arr} doesn't comply with this rule.`
-          });
-        }
-        return arr.join(DELIMITERS.stringArray);
-      });
-    } else if (hasMultiDimArrayId) {
-      throw new Error(errorMessage, {
-        cause: `[Type Mismatch] Every property with the ${multiDimArrayIdPrefix} prefix, must be a multi dimensional array of strings. However {${key}:${value}} was provided.`
-      });
-    }
-    if (typeof value === "string") return value.trim();
-    return value;
-  });
-}
-function unzip(data) {
-  const stringifiedData = JSON.stringify(data);
-  const errorMessage = `Failed to execute [${unzip.name}]`;
-  return JSON.parse(stringifiedData, (key, value) => {
-    const isIIKey = iiKeys.includes(key);
-    if (isIIKey && typeof value === "string") {
-      const validKey = key;
-      const splitProp = value.split(DELIMITERS[validKey]);
-      return Object.fromEntries(
-        Object.entries(INDEX_MAPPER[validKey]).map(([mapperKey, idx]) => {
-          return [mapperKey, splitProp[idx]?.trim?.() || ""];
-        })
-      );
-    } else if (isIIKey) {
-      throw new Error(errorMessage, {
-        cause: `[Type Mismatch] {${key}:string} expected, but {${key}:${value}} was provided.`
-      });
-    }
-    const hasArrayId = key.includes(stringArrayIdPrefix);
-    if (hasArrayId && typeof value === "string") {
-      return strictArray(value.split(DELIMITERS.stringArray));
-    } else if (hasArrayId) {
-      throw new Error(errorMessage, {
-        cause: `[Type Mismatch] {${key}:string} is required but {${key}:${value}} was provided.`
-      });
-    }
-    const hasMultiDimArrayId = key.includes(multiDimArrayIdPrefix);
-    if (hasMultiDimArrayId && Array.isArray(value)) {
-      const mapName = key.split(multiDimArrayDelim)?.[1];
-      return strictArray(value).map((delimString) => {
-        const splitStr = strictArray(delimString.split(DELIMITERS.stringArray));
-        if (!splitStr.every((d) => typeof d === "string"))
-          throw new Error(errorMessage, {
-            cause: `[Type Mismatch] Expected string[] but found ${splitStr}.`
-          });
-        if (mapName) return splitStr.map((value2) => ({ [mapName]: value2 }));
-        return splitStr;
-      });
-    } else if (hasMultiDimArrayId) {
-      throw new Error(errorMessage, {
-        cause: `[Type Mismatch] {${key}:string[]} is required but {${key}:${value}} was provided.`
-      });
-    }
-    return value;
-  });
-}
-var EVENTS = ["zip", "unzip"];
-var ServerDataAdapter = class {
-  invoke(event, data) {
-    switch (event) {
-      case "unzip":
-        return unzip(data);
-      case "zip":
-        return zip(data);
-      default:
-        event;
-        throw new Error(
-          `"${event}" is an unrecognized event. Try again using one of the following events ${EVENTS}.`
-        );
-    }
-  }
-};
-var serverDataAdapter = new ServerDataAdapter().invoke;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   addArticle,
@@ -1240,9 +1060,9 @@ var serverDataAdapter = new ServerDataAdapter().invoke;
   insertAt,
   isEmpty,
   isFile,
+  isFileDetails,
   isIterable,
   isLetter,
-  isLocalFile,
   isNumber,
   isPromise,
   lastIndex,
@@ -1270,8 +1090,6 @@ var serverDataAdapter = new ServerDataAdapter().invoke;
   removeAll,
   repeat,
   run,
-  sanitizeLocalFile,
-  serverDataAdapter,
   someValuesEmpty,
   sort,
   strictArray,

package/dist/main.d.cts

@@ -1,18 +1,29 @@
-import "@wavy/types"
-import { LocalFile, Name, Address, SanitizeFile, NonFunction, KnownFileTypeAlias, TaskResult, FromServer, NormalizeFromServer } from '@wavy/types';
+import "@wavy/util"
+import { FileDetails, Name, Address, NonFunction, KnownFileAlias, TaskResult } from '@wavy/util';
 
 type DateFormat = "MMM dd, yyyy" | "MMM dd, yyyy | hh:mm A" | "MMM dd, yyyy at hh:mm A" | "MMMM" | "yyyy" | "MMM yyyy" | "mm/dd/yyyy" | "mm/dd/yyyy hh:mm A" | "hh:mm A" | "hh:mm:ss A";
 
 declare const toObject: {
-    (file: File | Pick<File, "size" | "name" | "type" | "webkitRelativePath" | "lastModified">, options?: Partial<{
+    (file: File, options?: Partial<{
         uid?: string;
         uploadDate: number | "now";
         description: string;
         filepath: string;
         filename: string;
-        typeAlias: LocalFile["typeAlias"];
-    }> | undefined): LocalFile;
-    (localFile: LocalFile): File;
+        alias: FileDetails["alias"];
+    }> | undefined): FileDetails;
+    (details: {
+        lastModified: number | null;
+        sizeInBytes: number;
+        name: string;
+        path: string;
+        extension: string;
+        mime: string;
+        alias: "pdf" | "word" | "excel" | "img" | "txt" | "unknown";
+        uid?: string | undefined;
+        uploadDate?: number | undefined;
+        description?: string | undefined;
+    }): File;
 };
 
 type NumberFormatterTypes = {
@@ -67,9 +78,8 @@ declare const toMoney: (value: string | number, options?: NumberFormatterTypes["
  * @example parseDate, parseMoney, parseName, parseAddress, parseFileSize
  */
 declare function format<Event extends "date" | "money" | "name" | "address" | "file-size">(event: Event, ...args: Event extends "date" ? Parameters<typeof dateFormat> : Event extends "money" ? Parameters<typeof toMoney> : Event extends "name" ? Parameters<typeof nameToString> : Event extends "address" ? Parameters<typeof addressToString> : Event extends "file-size" ? [bytes: number] : never): Event extends "date" | "money" | "name" | "address" | "file-size" ? string : never;
-declare function sanitizeLocalFile({ _metadata: _, ...file }: LocalFile): SanitizeFile<LocalFile>;
 declare function isFile(value: unknown): value is File;
-declare function isLocalFile(value: unknown): value is LocalFile;
+declare function isFileDetails(value: unknown): value is FileDetails;
 declare function isIterable<T>(value: unknown): value is Iterable<T>;
 declare function isPromise<T>(value: unknown): value is Promise<T>;
 declare const parseDate: (time: number | Date | "now", format?: DateFormat) => string;
@@ -95,7 +105,7 @@ declare function pick<O extends object, K extends keyof O = keyof O>(value: O, k
 declare function omit<O extends object, K extends keyof O = keyof O>(value: O, keys: K[]): { [Key in Exclude<keyof O, K>]: O[Key] | null; };
 declare function omitNils<O extends object>(value: O): O;
 declare function map<T>(arr: T[], callback: (value: T, index: number, array: T[], end: () => void) => T): T[];
-declare function getMimeTypes(typeAliases: KnownFileTypeAlias[]): string[];
+declare function getMimeTypes(typeAliases: KnownFileAlias[]): string[];
 declare function classNameResolver(baseClassName: string): (className: string) => string;
 declare function classNameExt(rootClassName: string): (className: string) => string;
 declare function range(start: number, end: number): number[];
@@ -203,13 +213,4 @@ declare function arrayWithConst<T>(array: T[]): {
     asConst: readonly T[];
 };
 
-declare const serverDataAdapter: {
-    <DataType extends {
-        [key: string]: any;
-    }>(event: "zip", data: DataType): FromServer<DataType>;
-    <DataType extends {
-        [key: string]: any;
-    }>(event: "unzip", data: DataType): NormalizeFromServer<DataType>;
-};
-
-export { addArticle, arrayWithConst, asyncRun, averageOf, blankSpaces, buildArray, camelCaseToLetter, castArray, castReturn, classNameExt, classNameResolver, coerceIn, copyToClipboard, count, dataSearcher, distinct, drop, dropLast, dropLastWhile, dropWhile, format, getCaps, getFileExt, getFilename, getMimeTypes, group, hasIndex, ifDefined, ifEmpty, inRange, indexOf, indices, inferFilename, insertAt, isEmpty, isFile, isIterable, isLetter, isLocalFile, isNumber, isPromise, lastIndex, limit, map, mapToArray, maxOf, minOf, negate, omit, omitNils, ordinalIndicator, overwrite, parseAddress, parseDate, parseFileSize, parseMoney, parseName, pick, pluralize, poll, random, range, readClipboardText, removeAll, repeat, run, sanitizeLocalFile, serverDataAdapter, someValuesEmpty, sort, strictArray, stringToSearch, subObjectList, sumOf, take, takeLast, takeLastWhile, takeWhile, timeDuration, toNumber, toObject, trimString, undefinedIfEmpty, upperFirst, windowed };
+export { addArticle, arrayWithConst, asyncRun, averageOf, blankSpaces, buildArray, camelCaseToLetter, castArray, castReturn, classNameExt, classNameResolver, coerceIn, copyToClipboard, count, dataSearcher, distinct, drop, dropLast, dropLastWhile, dropWhile, format, getCaps, getFileExt, getFilename, getMimeTypes, group, hasIndex, ifDefined, ifEmpty, inRange, indexOf, indices, inferFilename, insertAt, isEmpty, isFile, isFileDetails, isIterable, isLetter, isNumber, isPromise, lastIndex, limit, map, mapToArray, maxOf, minOf, negate, omit, omitNils, ordinalIndicator, overwrite, parseAddress, parseDate, parseFileSize, parseMoney, parseName, pick, pluralize, poll, random, range, readClipboardText, removeAll, repeat, run, someValuesEmpty, sort, strictArray, stringToSearch, subObjectList, sumOf, take, takeLast, takeLastWhile, takeWhile, timeDuration, toNumber, toObject, trimString, undefinedIfEmpty, upperFirst, windowed };

package/dist/main.d.ts

@@ -1,18 +1,29 @@
-import "@wavy/types"
-import { LocalFile, Name, Address, SanitizeFile, NonFunction, KnownFileTypeAlias, TaskResult, FromServer, NormalizeFromServer } from '@wavy/types';
+import "@wavy/util"
+import { FileDetails, Name, Address, NonFunction, KnownFileAlias, TaskResult } from '@wavy/util';
 
 type DateFormat = "MMM dd, yyyy" | "MMM dd, yyyy | hh:mm A" | "MMM dd, yyyy at hh:mm A" | "MMMM" | "yyyy" | "MMM yyyy" | "mm/dd/yyyy" | "mm/dd/yyyy hh:mm A" | "hh:mm A" | "hh:mm:ss A";
 
 declare const toObject: {
-    (file: File | Pick<File, "size" | "name" | "type" | "webkitRelativePath" | "lastModified">, options?: Partial<{
+    (file: File, options?: Partial<{
         uid?: string;
         uploadDate: number | "now";
         description: string;
         filepath: string;
         filename: string;
-        typeAlias: LocalFile["typeAlias"];
-    }> | undefined): LocalFile;
-    (localFile: LocalFile): File;
+        alias: FileDetails["alias"];
+    }> | undefined): FileDetails;
+    (details: {
+        lastModified: number | null;
+        sizeInBytes: number;
+        name: string;
+        path: string;
+        extension: string;
+        mime: string;
+        alias: "pdf" | "word" | "excel" | "img" | "txt" | "unknown";
+        uid?: string | undefined;
+        uploadDate?: number | undefined;
+        description?: string | undefined;
+    }): File;
 };
 
 type NumberFormatterTypes = {
@@ -67,9 +78,8 @@ declare const toMoney: (value: string | number, options?: NumberFormatterTypes["
  * @example parseDate, parseMoney, parseName, parseAddress, parseFileSize
  */
 declare function format<Event extends "date" | "money" | "name" | "address" | "file-size">(event: Event, ...args: Event extends "date" ? Parameters<typeof dateFormat> : Event extends "money" ? Parameters<typeof toMoney> : Event extends "name" ? Parameters<typeof nameToString> : Event extends "address" ? Parameters<typeof addressToString> : Event extends "file-size" ? [bytes: number] : never): Event extends "date" | "money" | "name" | "address" | "file-size" ? string : never;
-declare function sanitizeLocalFile({ _metadata: _, ...file }: LocalFile): SanitizeFile<LocalFile>;
 declare function isFile(value: unknown): value is File;
-declare function isLocalFile(value: unknown): value is LocalFile;
+declare function isFileDetails(value: unknown): value is FileDetails;
 declare function isIterable<T>(value: unknown): value is Iterable<T>;
 declare function isPromise<T>(value: unknown): value is Promise<T>;
 declare const parseDate: (time: number | Date | "now", format?: DateFormat) => string;
@@ -95,7 +105,7 @@ declare function pick<O extends object, K extends keyof O = keyof O>(value: O, k
 declare function omit<O extends object, K extends keyof O = keyof O>(value: O, keys: K[]): { [Key in Exclude<keyof O, K>]: O[Key] | null; };
 declare function omitNils<O extends object>(value: O): O;
 declare function map<T>(arr: T[], callback: (value: T, index: number, array: T[], end: () => void) => T): T[];
-declare function getMimeTypes(typeAliases: KnownFileTypeAlias[]): string[];
+declare function getMimeTypes(typeAliases: KnownFileAlias[]): string[];
 declare function classNameResolver(baseClassName: string): (className: string) => string;
 declare function classNameExt(rootClassName: string): (className: string) => string;
 declare function range(start: number, end: number): number[];
@@ -203,13 +213,4 @@ declare function arrayWithConst<T>(array: T[]): {
     asConst: readonly T[];
 };
 
-declare const serverDataAdapter: {
-    <DataType extends {
-        [key: string]: any;
-    }>(event: "zip", data: DataType): FromServer<DataType>;
-    <DataType extends {
-        [key: string]: any;
-    }>(event: "unzip", data: DataType): NormalizeFromServer<DataType>;
-};
-
-export { addArticle, arrayWithConst, asyncRun, averageOf, blankSpaces, buildArray, camelCaseToLetter, castArray, castReturn, classNameExt, classNameResolver, coerceIn, copyToClipboard, count, dataSearcher, distinct, drop, dropLast, dropLastWhile, dropWhile, format, getCaps, getFileExt, getFilename, getMimeTypes, group, hasIndex, ifDefined, ifEmpty, inRange, indexOf, indices, inferFilename, insertAt, isEmpty, isFile, isIterable, isLetter, isLocalFile, isNumber, isPromise, lastIndex, limit, map, mapToArray, maxOf, minOf, negate, omit, omitNils, ordinalIndicator, overwrite, parseAddress, parseDate, parseFileSize, parseMoney, parseName, pick, pluralize, poll, random, range, readClipboardText, removeAll, repeat, run, sanitizeLocalFile, serverDataAdapter, someValuesEmpty, sort, strictArray, stringToSearch, subObjectList, sumOf, take, takeLast, takeLastWhile, takeWhile, timeDuration, toNumber, toObject, trimString, undefinedIfEmpty, upperFirst, windowed };
+export { addArticle, arrayWithConst, asyncRun, averageOf, blankSpaces, buildArray, camelCaseToLetter, castArray, castReturn, classNameExt, classNameResolver, coerceIn, copyToClipboard, count, dataSearcher, distinct, drop, dropLast, dropLastWhile, dropWhile, format, getCaps, getFileExt, getFilename, getMimeTypes, group, hasIndex, ifDefined, ifEmpty, inRange, indexOf, indices, inferFilename, insertAt, isEmpty, isFile, isFileDetails, isIterable, isLetter, isNumber, isPromise, lastIndex, limit, map, mapToArray, maxOf, minOf, negate, omit, omitNils, ordinalIndicator, overwrite, parseAddress, parseDate, parseFileSize, parseMoney, parseName, pick, pluralize, poll, random, range, readClipboardText, removeAll, repeat, run, someValuesEmpty, sort, strictArray, stringToSearch, subObjectList, sumOf, take, takeLast, takeLastWhile, takeWhile, timeDuration, toNumber, toObject, trimString, undefinedIfEmpty, upperFirst, windowed };

package/dist/main.js

@@ -1,13 +1,14 @@
 // src/helper-functions/HelperFunctions.ts
 import {
-  LOCAL_FILE_MIME_TYPES as LOCAL_FILE_MIME_TYPES2
-} from "@wavy/types";
+  FILE_MIME_TYPES as FILE_MIME_TYPES2,
+  FileDetails as FileDetails2
+} from "@wavy/util";
 
 // src/helper-functions/components/ObjectConverter.ts
 import { v4 } from "uuid";
-import { LOCAL_FILE_MIME_TYPES } from "@wavy/types";
+import { FILE_MIME_TYPES } from "@wavy/util";
 import { log } from "console";
-function fileToLocalFile(file, options) {
+function fileToFileDetails(file, options) {
   const fileExt = getFileExt(file.name);
   const fileName = (() => {
     if (options?.filename && options.filename.includes(fileExt))
@@ -15,15 +16,17 @@ function fileToLocalFile(file, options) {
     else if (options?.filename) return options.filename.trim() + fileExt;
     return file.name;
   })()?.trim?.();
-  const { name: _, size: __, ..._metadata } = file;
+  const { name: _, size: __ } = file;
   return {
     uid: options?.uid || v4(),
     description: options?.description,
-    ext: fileExt,
+    extension: fileExt,
     path: options?.filepath || file?.webkitRelativePath,
-    typeAlias: options?.typeAlias || run(
-      Object.keys(LOCAL_FILE_MIME_TYPES).find(
-        (key) => LOCAL_FILE_MIME_TYPES[key].includes(file.type)
+    alias: options?.alias || run(
+      Object.keys(FILE_MIME_TYPES).find(
+        (key) => FILE_MIME_TYPES[key].includes(
+          file.type
+        )
       ),
       (type) => {
         if (!type) {
@@ -36,23 +39,35 @@ function fileToLocalFile(file, options) {
     sizeInBytes: file.size,
     uploadDate: options?.uploadDate === "now" ? Date.now() : options?.uploadDate ?? file?.lastModified,
     name: fileName,
-    _metadata
+    mime: file.type,
+    lastModified: file.lastModified
   };
 }
-function localFileToFile(localFile) {
+function fileDetailsToFile(details) {
   return {
-    name: localFile.name,
-    size: localFile.sizeInBytes,
-    ...localFile._metadata
+    name: details.name,
+    size: details.sizeInBytes,
+    webkitRelativePath: details.path,
+    lastModified: details.lastModified,
+    type: details.mime,
+    arrayBuffer: null,
+    bytes: null,
+    slice: null,
+    stream: null,
+    text: null
   };
 }
 var Overloader = class {
   invoke(...args) {
     if (isFile(args[0])) {
-      return fileToLocalFile(...args);
+      return fileToFileDetails(
+        ...args
+      );
     }
-    if (isLocalFile(args[0])) {
-      return localFileToFile(...args);
+    if (isFileDetails(args[0])) {
+      return fileDetailsToFile(
+        ...args
+      );
     } else throw new Error(`The arguments supplied are insufficient.`);
   }
 };
@@ -470,12 +485,6 @@ function format(event, ...args) {
       return event;
   }
 }
-function sanitizeLocalFile({
-  _metadata: _,
-  ...file
-}) {
-  return file;
-}
 function isFile(value) {
   const requiredKeys = [
     "name",
@@ -488,25 +497,14 @@ function isFile(value) {
     return true;
   return false;
 }
-function isLocalFile(value) {
-  const dummyLocalFile = {
-    name: "",
-    description: "",
-    path: "",
-    sizeInBytes: 0,
-    ext: "",
-    typeAlias: "unknown",
-    uid: "",
-    uploadDate: 0,
-    _metadata: void 0
-  };
-  const optionalKeys = ["description"];
-  const requiredKeys = Object.keys(dummyLocalFile).filter((key) => !optionalKeys.includes(key));
-  const allKeys = [requiredKeys, optionalKeys].flat();
-  if (value && typeof value === "object" && requiredKeys.every((key) => key in value) && Object.keys(value).every((key) => allKeys.includes(key))) {
+function isFileDetails(value) {
+  try {
+    FileDetails2.parse(value);
     return true;
+  } catch (error) {
+    console.error(error);
+    return false;
   }
-  return false;
 }
 function isIterable(value) {
   return !!value && typeof value === "object" && Symbol.iterator in value && typeof value[Symbol.iterator] === "function";
@@ -615,7 +613,7 @@ function map(arr, callback) {
   return arr;
 }
 function getMimeTypes(typeAliases) {
-  return distinct(strictArray(typeAliases)).map((alias) => LOCAL_FILE_MIME_TYPES2[alias]).flat();
+  return distinct(strictArray(typeAliases)).map((alias) => FILE_MIME_TYPES2[alias]).flat();
 }
 function classNameResolver(baseClassName) {
   return (className) => {
@@ -885,7 +883,7 @@ async function copyToClipboard(text) {
     if (err instanceof Error) {
       return {
         error: {
-          errorCode: "UNKNOWN",
+          code: "UNKNOWN",
           title: err.name,
           message: err.message
         }
@@ -893,7 +891,7 @@ async function copyToClipboard(text) {
     }
     return {
       error: {
-        errorCode: "UNKNOWN",
+        code: "UNKNOWN",
         title: "Failed to copy text",
         message: JSON.stringify(err)
       }
@@ -907,7 +905,7 @@ async function readClipboardText() {
   } catch (err) {
     return {
       error: {
-        errorCode: "UNKNOWN",
+        code: "UNKNOWN",
         title: "Failed to read clipboard contents",
         message: `Something went wrong while trying to read the clipboard contents. [CAUSE]: ${JSON.stringify(
           err
@@ -919,181 +917,6 @@ async function readClipboardText() {
 function arrayWithConst(array) {
   return { value: array, asConst: [...array] };
 }
-
-// src/server-adapters/ServerAdapters.ts
-import "@wavy/types";
-var iiKeys = Object.keys({
-  name: null,
-  address: null
-});
-var stringArrayIdPrefix = "listOf";
-var multiDimArrayIdPrefix = "2DListOf";
-var multiDimArrayDelim = ":";
-var DELIMITERS = {
-  name: " ",
-  address: "|",
-  phoneNumber: " ",
-  stringArray: " "
-};
-var INDEX_MAPPER = {
-  name: { first: 0, last: 1 },
-  address: {
-    streetAddress: 0,
-    city: 1,
-    parish: 2,
-    country: 3
-  }
-};
-function zip(data) {
-  const stringifiedData = JSON.stringify(data);
-  const errorMessage = `Failed to execute [${zip.name}].`;
-  return JSON.parse(stringifiedData, (key, value) => {
-    if (iiKeys.includes(key)) {
-      const validKey = key;
-      const handleTypeMismatchError = (required) => {
-        if (typeof required !== typeof value) {
-          throw new Error(errorMessage, {
-            cause: `[Type Mismatch] Property type {${key}:${JSON.stringify(
-              required
-            )}} is required, but {${key}:${JSON.stringify(
-              value
-            )}} was provided.`
-          });
-        }
-      };
-      switch (validKey) {
-        case "name":
-          handleTypeMismatchError({ first: "", last: "" });
-          break;
-        case "address":
-          handleTypeMismatchError({
-            streetAddress: "",
-            city: "",
-            parish: "",
-            country: "Jamaica"
-          });
-          break;
-        default:
-          return validKey;
-      }
-      let group2 = [];
-      Object.keys(INDEX_MAPPER[validKey]).forEach((prop) => {
-        const validProp = prop;
-        group2[INDEX_MAPPER[validKey][validProp]] = value[validProp]?.trim?.() || "";
-      });
-      return group2.join(DELIMITERS[validKey]).trim();
-    }
-    const valueIsArray = Array.isArray(value);
-    const hasArrayId = key.includes(stringArrayIdPrefix);
-    if (hasArrayId && valueIsArray && strictArray(value).every((v) => typeof v === "string")) {
-      return strictArray(value).join(DELIMITERS.stringArray).trim();
-    } else if (hasArrayId) {
-      throw new Error(errorMessage, {
-        cause: `[Type Mismatch] Every property with the ${stringArrayIdPrefix} prefix, must be an array of strings. However {${key}:${value}} was provided.`
-      });
-    }
-    const hasMultiDimArrayId = key.includes(multiDimArrayIdPrefix);
-    if (hasMultiDimArrayId && valueIsArray && key.includes(multiDimArrayDelim) && value.every(
-      (d) => Array.isArray(d) && d.every((sv) => typeof sv === "object")
-    )) {
-      const mapName = key.split(multiDimArrayDelim)[1];
-      return strictArray(value).map(
-        (objArr) => strictArray(objArr).map((obj) => {
-          if (mapName in obj) {
-            const mapValue = obj[mapName];
-            if (typeof mapValue !== "string") {
-              throw new Error(errorMessage, {
-                cause: `[Type Mismatch] Expected {${mapName}:string} but {${mapName}:${mapValue}} was provided.`
-              });
-            }
-            return mapValue;
-          } else
-            throw new Error(errorMessage, {
-              cause: `[Type Mismatch] Every object in the multi dimensional array must have a property with the name ${mapName}. However ${obj} doesn't adhere to this rule.`
-            });
-        }).join(DELIMITERS.stringArray)
-      );
-    } else if (hasMultiDimArrayId && valueIsArray) {
-      return value.map((arr) => {
-        if (!arr.every((d) => typeof d === "string")) {
-          throw new Error(errorMessage, {
-            cause: `[Type Mismatch] Every sub type of the array must be a string. However ${arr} doesn't comply with this rule.`
-          });
-        }
-        return arr.join(DELIMITERS.stringArray);
-      });
-    } else if (hasMultiDimArrayId) {
-      throw new Error(errorMessage, {
-        cause: `[Type Mismatch] Every property with the ${multiDimArrayIdPrefix} prefix, must be a multi dimensional array of strings. However {${key}:${value}} was provided.`
-      });
-    }
-    if (typeof value === "string") return value.trim();
-    return value;
-  });
-}
-function unzip(data) {
-  const stringifiedData = JSON.stringify(data);
-  const errorMessage = `Failed to execute [${unzip.name}]`;
-  return JSON.parse(stringifiedData, (key, value) => {
-    const isIIKey = iiKeys.includes(key);
-    if (isIIKey && typeof value === "string") {
-      const validKey = key;
-      const splitProp = value.split(DELIMITERS[validKey]);
-      return Object.fromEntries(
-        Object.entries(INDEX_MAPPER[validKey]).map(([mapperKey, idx]) => {
-          return [mapperKey, splitProp[idx]?.trim?.() || ""];
-        })
-      );
-    } else if (isIIKey) {
-      throw new Error(errorMessage, {
-        cause: `[Type Mismatch] {${key}:string} expected, but {${key}:${value}} was provided.`
-      });
-    }
-    const hasArrayId = key.includes(stringArrayIdPrefix);
-    if (hasArrayId && typeof value === "string") {
-      return strictArray(value.split(DELIMITERS.stringArray));
-    } else if (hasArrayId) {
-      throw new Error(errorMessage, {
-        cause: `[Type Mismatch] {${key}:string} is required but {${key}:${value}} was provided.`
-      });
-    }
-    const hasMultiDimArrayId = key.includes(multiDimArrayIdPrefix);
-    if (hasMultiDimArrayId && Array.isArray(value)) {
-      const mapName = key.split(multiDimArrayDelim)?.[1];
-      return strictArray(value).map((delimString) => {
-        const splitStr = strictArray(delimString.split(DELIMITERS.stringArray));
-        if (!splitStr.every((d) => typeof d === "string"))
-          throw new Error(errorMessage, {
-            cause: `[Type Mismatch] Expected string[] but found ${splitStr}.`
-          });
-        if (mapName) return splitStr.map((value2) => ({ [mapName]: value2 }));
-        return splitStr;
-      });
-    } else if (hasMultiDimArrayId) {
-      throw new Error(errorMessage, {
-        cause: `[Type Mismatch] {${key}:string[]} is required but {${key}:${value}} was provided.`
-      });
-    }
-    return value;
-  });
-}
-var EVENTS = ["zip", "unzip"];
-var ServerDataAdapter = class {
-  invoke(event, data) {
-    switch (event) {
-      case "unzip":
-        return unzip(data);
-      case "zip":
-        return zip(data);
-      default:
-        event;
-        throw new Error(
-          `"${event}" is an unrecognized event. Try again using one of the following events ${EVENTS}.`
-        );
-    }
-  }
-};
-var serverDataAdapter = new ServerDataAdapter().invoke;
 export {
   addArticle,
   arrayWithConst,
@@ -1131,9 +954,9 @@ export {
   insertAt,
   isEmpty,
   isFile,
+  isFileDetails,
   isIterable,
   isLetter,
-  isLocalFile,
   isNumber,
   isPromise,
   lastIndex,
@@ -1161,8 +984,6 @@ export {
   removeAll,
   repeat,
   run,
-  sanitizeLocalFile,
-  serverDataAdapter,
   someValuesEmpty,
   sort,
   strictArray,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wavy/fn",
-  "version": "0.0.27",
+  "version": "0.0.28",
   "main": "./dist/main.js",
   "module": "./dist/main.cjs",
   "types": "./dist/main.d.ts",
@@ -25,9 +25,10 @@
   "description": "",
   "devDependencies": {
     "@types/node": "^24.5.2",
-    "@wavy/types": "^0.0.46",
+    "@wavy/util": "^0.0.6",
     "tsup": "^8.5.0",
-    "typescript": "^5.9.2"
+    "typescript": "^5.9.2",
+    "zod": "^4.2.1"
   },
   "dependencies": {
     "uuid": "^13.0.0"