@alextheman/utility 2.11.0 → 2.12.0

package/dist/index.cjs

@@ -122,15 +122,19 @@ function convertFileToBase64(file) {
 var convertFileToBase64_default = convertFileToBase64;
 
 // src/functions/createFormData.ts
-function createFormData(data, options = { nullableResolution: "empty" }) {
+function getNullableResolutionStrategy(key, strategy) {
+  var _a;
+  return (_a = typeof strategy === "object" ? strategy[key] : strategy) != null ? _a : "empty";
+}
+function createFormData(data, options = { arrayResolution: "stringify", nullableResolution: "empty" }) {
   const formData = new FormData();
-  function resolveByStrategy(key, value, resolutionStrategy) {
+  function resolveNullablesByStrategy(key, value, resolutionStrategy) {
     switch (resolutionStrategy) {
       case "empty":
-        formData.append(key, "");
+        formData.append(String(key), "");
         break;
       case "stringify":
-        formData.append(key, JSON.stringify(value));
+        formData.append(String(key), JSON.stringify(value));
         break;
       case "omit":
         break;
@@ -138,28 +142,52 @@ function createFormData(data, options = { nullableResolution: "empty" }) {
         throw new TypeError("SLOPPY_PURE_JAVASCRIPT_USER_ERROR");
     }
   }
-  for (const key in data) {
-    if (data[key] instanceof Blob) {
-      formData.append(key, data[key]);
-    } else if (data[key] === void 0 || data[key] === null) {
-      if (options.nullableResolution) {
-        resolveByStrategy(key, data[key], options.nullableResolution);
-        continue;
+  function resolveNullables(key, value, options2) {
+    if (options2.nullableResolution) {
+      resolveNullablesByStrategy(
+        key,
+        value,
+        getNullableResolutionStrategy(key, options2.nullableResolution)
+      );
+      return;
+    }
+    if (options2.undefinedResolution || options2.nullResolution) {
+      if (data[key] === void 0 && options2.undefinedResolution) {
+        resolveNullablesByStrategy(
+          key,
+          value,
+          getNullableResolutionStrategy(key, options2.undefinedResolution)
+        );
+        return;
       }
-      if (options.undefinedResolution || options.nullResolution) {
-        if (data[key] === void 0 && options.undefinedResolution) {
-          resolveByStrategy(key, data[key], options.undefinedResolution);
-          continue;
-        }
-        if (data[key] === null && options.nullResolution) {
-          resolveByStrategy(key, data[key], options.nullResolution);
-          continue;
+      if (data[key] === null && options2.nullResolution) {
+        resolveNullablesByStrategy(
+          key,
+          value,
+          getNullableResolutionStrategy(key, options2.nullResolution)
+        );
+      }
+    }
+  }
+  const entries = Object.entries(data);
+  for (const [key, value] of entries) {
+    if (value instanceof Blob) {
+      formData.append(String(key), value);
+    } else if (value === void 0 || value === null) {
+      resolveNullables(key, value, options);
+    } else if (typeof value === "object") {
+      if (Array.isArray(value) && (options.arrayResolution === "multiple" || typeof options.arrayResolution === "object" && options.arrayResolution[key] === "multiple")) {
+        for (const item of value) {
+          if ((typeof item === "object" || !item) && !(item instanceof Blob)) {
+            throw new TypeError("NON_PRIMITIVE_ARRAY_ITEMS_FOUND");
+          }
+          formData.append(String(key), String(item));
         }
+        continue;
       }
-    } else if (typeof data[key] === "object") {
-      formData.append(key, JSON.stringify(data[key]));
+      formData.append(String(key), JSON.stringify(value));
     } else {
-      formData.append(key, String(data[key]));
+      formData.append(String(key), String(value));
     }
   }
   return formData;

package/dist/index.d.cts

@@ -8,21 +8,60 @@ declare function camelToKebab(string: string): string;
 
 declare function convertFileToBase64(file: File): Promise<string>;
 
-type FormDataResolutionStrategy = "stringify" | "empty" | "omit";
-interface CreateFormDataOptionsUndefinedOrNullResolution {
-    undefinedResolution?: FormDataResolutionStrategy;
-    nullResolution?: FormDataResolutionStrategy;
+type HTTPErrorCode = 400 | 401 | 403 | 404 | 418 | 500;
+/** @deprecated This type has been renamed to HTTPErrorCode (singular) */
+type HTTPErrorCodes = 400 | 401 | 403 | 404 | 418 | 500;
+declare const httpErrorCodeLookup: Record<HTTPErrorCode, string>;
+declare class APIError extends Error {
+    status: number;
+    constructor(status?: HTTPErrorCode | number, message?: string, options?: ErrorOptions);
+    static check(input: unknown): input is APIError;
+}
+
+declare const emailSchema: z.core.$ZodBranded<z.ZodEmail, "Email">;
+type Email = z.infer<typeof emailSchema>;
+declare function parseEmail(data: unknown): Email;
+
+declare const envSchema: z$1.ZodEnum<{
+    test: "test";
+    development: "development";
+    production: "production";
+}>;
+type Env = z$1.infer<typeof envSchema>;
+declare function parseEnv(data?: unknown): Env;
+
+declare const uuidSchema: z.core.$ZodBranded<z.ZodUUID, "UUID">;
+type UUID = z.infer<typeof uuidSchema>;
+declare function parseUUID(UUID: unknown): UUID;
+
+type DisallowUndefined<T> = undefined extends T ? ["Error: Generic type cannot include undefined"] : T;
+
+type NonUndefined<T> = T extends undefined ? never : T;
+
+type OptionalOnCondition<Condition extends boolean, T> = Condition extends true ? T : T | undefined;
+
+type RecordKey = string | number | symbol;
+
+type FormDataNullableResolutionStrategy = "stringify" | "empty" | "omit";
+type FormDataArrayResolutionStrategy = "stringify" | "multiple";
+interface CreateFormDataOptionsBase<K extends RecordKey> {
+    arrayResolution?: FormDataArrayResolutionStrategy | Partial<Record<K, FormDataArrayResolutionStrategy>>;
+}
+interface CreateFormDataOptionsUndefinedOrNullResolution<K extends RecordKey> extends CreateFormDataOptionsBase<K> {
+    undefinedResolution?: FormDataNullableResolutionStrategy | Partial<Record<K, FormDataNullableResolutionStrategy>>;
+    nullResolution?: FormDataNullableResolutionStrategy | Partial<Record<K, FormDataNullableResolutionStrategy>>;
     nullableResolution?: never;
 }
-interface CreateFormDataOptionsNullableResolution {
+interface CreateFormDataOptionsNullableResolution<K extends RecordKey> extends CreateFormDataOptionsBase<K> {
     undefinedResolution?: never;
     nullResolution?: never;
-    nullableResolution: FormDataResolutionStrategy;
+    nullableResolution: FormDataNullableResolutionStrategy | Partial<Record<K, FormDataNullableResolutionStrategy>>;
 }
-type CreateFormDataOptions = CreateFormDataOptionsUndefinedOrNullResolution | CreateFormDataOptionsNullableResolution;
-declare function createFormData<T extends Record<string, unknown>>(data: T, options?: CreateFormDataOptions): FormData;
+type CreateFormDataOptions<K extends RecordKey> = CreateFormDataOptionsUndefinedOrNullResolution<K> | CreateFormDataOptionsNullableResolution<K>;
+declare function createFormData<T extends Record<RecordKey, unknown>, K extends keyof T>(data: T, options?: CreateFormDataOptions<K>): FormData;
 
-declare function fillArray<T>(callback: (index: number) => T | Promise<T>, length?: number): T[] | Promise<T[]>;
+declare function fillArray<T>(callback: (index: number) => Promise<T>, length?: number): Promise<T[]>;
+declare function fillArray<T>(callback: (index: number) => T, length?: number): T[];
 
 declare function formatDateAndTime(inputDate: Date): string;
 
@@ -60,36 +99,4 @@ declare function wait(seconds: number): Promise<void>;
 
 declare function interpolateObjects(strings: TemplateStringsArray, ...values: unknown[]): string;
 
-type HTTPErrorCode = 400 | 401 | 403 | 404 | 418 | 500;
-/** @deprecated This type has been renamed to HTTPErrorCode (singular) */
-type HTTPErrorCodes = 400 | 401 | 403 | 404 | 418 | 500;
-declare const httpErrorCodeLookup: Record<HTTPErrorCode, string>;
-declare class APIError extends Error {
-    status: number;
-    constructor(status?: HTTPErrorCode | number, message?: string, options?: ErrorOptions);
-    static check(input: unknown): input is APIError;
-}
-
-declare const emailSchema: z.core.$ZodBranded<z.ZodEmail, "Email">;
-type Email = z.infer<typeof emailSchema>;
-declare function parseEmail(data: unknown): Email;
-
-declare const envSchema: z$1.ZodEnum<{
-    test: "test";
-    development: "development";
-    production: "production";
-}>;
-type Env = z$1.infer<typeof envSchema>;
-declare function parseEnv(data?: unknown): Env;
-
-declare const uuidSchema: z.core.$ZodBranded<z.ZodUUID, "UUID">;
-type UUID = z.infer<typeof uuidSchema>;
-declare function parseUUID(UUID: unknown): UUID;
-
-type DisallowUndefined<T> = undefined extends T ? ["Error: Generic type cannot include undefined"] : T;
-
-type NonUndefined<T> = T extends undefined ? never : T;
-
-type OptionalOnCondition<Condition extends boolean, T> = Condition extends true ? T : T | undefined;
-
-export { APIError, type CreateFormDataOptions, type CreateFormDataOptionsNullableResolution, type CreateFormDataOptionsUndefinedOrNullResolution, type DisallowUndefined, type Email, type Env, type FormDataResolutionStrategy, type HTTPErrorCode, type HTTPErrorCodes, type NonUndefined, type OptionalOnCondition, type StringListToArrayOptions, type UUID, addDaysToDate, appendSemicolon, camelToKebab, convertFileToBase64, createFormData, fillArray, formatDateAndTime, getRandomNumber, httpErrorCodeLookup, interpolateObjects, isLeapYear, isMonthlyMultiple, isOrdered, isSameDate, omitProperties, parseEmail, parseEnv, parseIntStrict, parseUUID, randomiseArray, range, removeDuplicates, stringListToArray, stringToBoolean, truncate, wait };
+export { APIError, type CreateFormDataOptions, type CreateFormDataOptionsNullableResolution, type CreateFormDataOptionsUndefinedOrNullResolution, type DisallowUndefined, type Email, type Env, type FormDataNullableResolutionStrategy as FormDataResolutionStrategy, type HTTPErrorCode, type HTTPErrorCodes, type NonUndefined, type OptionalOnCondition, type RecordKey, type StringListToArrayOptions, type UUID, addDaysToDate, appendSemicolon, camelToKebab, convertFileToBase64, createFormData, fillArray, formatDateAndTime, getRandomNumber, httpErrorCodeLookup, interpolateObjects, isLeapYear, isMonthlyMultiple, isOrdered, isSameDate, omitProperties, parseEmail, parseEnv, parseIntStrict, parseUUID, randomiseArray, range, removeDuplicates, stringListToArray, stringToBoolean, truncate, wait };

package/dist/index.d.ts

@@ -8,21 +8,60 @@ declare function camelToKebab(string: string): string;
 
 declare function convertFileToBase64(file: File): Promise<string>;
 
-type FormDataResolutionStrategy = "stringify" | "empty" | "omit";
-interface CreateFormDataOptionsUndefinedOrNullResolution {
-    undefinedResolution?: FormDataResolutionStrategy;
-    nullResolution?: FormDataResolutionStrategy;
+type HTTPErrorCode = 400 | 401 | 403 | 404 | 418 | 500;
+/** @deprecated This type has been renamed to HTTPErrorCode (singular) */
+type HTTPErrorCodes = 400 | 401 | 403 | 404 | 418 | 500;
+declare const httpErrorCodeLookup: Record<HTTPErrorCode, string>;
+declare class APIError extends Error {
+    status: number;
+    constructor(status?: HTTPErrorCode | number, message?: string, options?: ErrorOptions);
+    static check(input: unknown): input is APIError;
+}
+
+declare const emailSchema: z.core.$ZodBranded<z.ZodEmail, "Email">;
+type Email = z.infer<typeof emailSchema>;
+declare function parseEmail(data: unknown): Email;
+
+declare const envSchema: z$1.ZodEnum<{
+    test: "test";
+    development: "development";
+    production: "production";
+}>;
+type Env = z$1.infer<typeof envSchema>;
+declare function parseEnv(data?: unknown): Env;
+
+declare const uuidSchema: z.core.$ZodBranded<z.ZodUUID, "UUID">;
+type UUID = z.infer<typeof uuidSchema>;
+declare function parseUUID(UUID: unknown): UUID;
+
+type DisallowUndefined<T> = undefined extends T ? ["Error: Generic type cannot include undefined"] : T;
+
+type NonUndefined<T> = T extends undefined ? never : T;
+
+type OptionalOnCondition<Condition extends boolean, T> = Condition extends true ? T : T | undefined;
+
+type RecordKey = string | number | symbol;
+
+type FormDataNullableResolutionStrategy = "stringify" | "empty" | "omit";
+type FormDataArrayResolutionStrategy = "stringify" | "multiple";
+interface CreateFormDataOptionsBase<K extends RecordKey> {
+    arrayResolution?: FormDataArrayResolutionStrategy | Partial<Record<K, FormDataArrayResolutionStrategy>>;
+}
+interface CreateFormDataOptionsUndefinedOrNullResolution<K extends RecordKey> extends CreateFormDataOptionsBase<K> {
+    undefinedResolution?: FormDataNullableResolutionStrategy | Partial<Record<K, FormDataNullableResolutionStrategy>>;
+    nullResolution?: FormDataNullableResolutionStrategy | Partial<Record<K, FormDataNullableResolutionStrategy>>;
     nullableResolution?: never;
 }
-interface CreateFormDataOptionsNullableResolution {
+interface CreateFormDataOptionsNullableResolution<K extends RecordKey> extends CreateFormDataOptionsBase<K> {
     undefinedResolution?: never;
     nullResolution?: never;
-    nullableResolution: FormDataResolutionStrategy;
+    nullableResolution: FormDataNullableResolutionStrategy | Partial<Record<K, FormDataNullableResolutionStrategy>>;
 }
-type CreateFormDataOptions = CreateFormDataOptionsUndefinedOrNullResolution | CreateFormDataOptionsNullableResolution;
-declare function createFormData<T extends Record<string, unknown>>(data: T, options?: CreateFormDataOptions): FormData;
+type CreateFormDataOptions<K extends RecordKey> = CreateFormDataOptionsUndefinedOrNullResolution<K> | CreateFormDataOptionsNullableResolution<K>;
+declare function createFormData<T extends Record<RecordKey, unknown>, K extends keyof T>(data: T, options?: CreateFormDataOptions<K>): FormData;
 
-declare function fillArray<T>(callback: (index: number) => T | Promise<T>, length?: number): T[] | Promise<T[]>;
+declare function fillArray<T>(callback: (index: number) => Promise<T>, length?: number): Promise<T[]>;
+declare function fillArray<T>(callback: (index: number) => T, length?: number): T[];
 
 declare function formatDateAndTime(inputDate: Date): string;
 
@@ -60,36 +99,4 @@ declare function wait(seconds: number): Promise<void>;
 
 declare function interpolateObjects(strings: TemplateStringsArray, ...values: unknown[]): string;
 
-type HTTPErrorCode = 400 | 401 | 403 | 404 | 418 | 500;
-/** @deprecated This type has been renamed to HTTPErrorCode (singular) */
-type HTTPErrorCodes = 400 | 401 | 403 | 404 | 418 | 500;
-declare const httpErrorCodeLookup: Record<HTTPErrorCode, string>;
-declare class APIError extends Error {
-    status: number;
-    constructor(status?: HTTPErrorCode | number, message?: string, options?: ErrorOptions);
-    static check(input: unknown): input is APIError;
-}
-
-declare const emailSchema: z.core.$ZodBranded<z.ZodEmail, "Email">;
-type Email = z.infer<typeof emailSchema>;
-declare function parseEmail(data: unknown): Email;
-
-declare const envSchema: z$1.ZodEnum<{
-    test: "test";
-    development: "development";
-    production: "production";
-}>;
-type Env = z$1.infer<typeof envSchema>;
-declare function parseEnv(data?: unknown): Env;
-
-declare const uuidSchema: z.core.$ZodBranded<z.ZodUUID, "UUID">;
-type UUID = z.infer<typeof uuidSchema>;
-declare function parseUUID(UUID: unknown): UUID;
-
-type DisallowUndefined<T> = undefined extends T ? ["Error: Generic type cannot include undefined"] : T;
-
-type NonUndefined<T> = T extends undefined ? never : T;
-
-type OptionalOnCondition<Condition extends boolean, T> = Condition extends true ? T : T | undefined;
-
-export { APIError, type CreateFormDataOptions, type CreateFormDataOptionsNullableResolution, type CreateFormDataOptionsUndefinedOrNullResolution, type DisallowUndefined, type Email, type Env, type FormDataResolutionStrategy, type HTTPErrorCode, type HTTPErrorCodes, type NonUndefined, type OptionalOnCondition, type StringListToArrayOptions, type UUID, addDaysToDate, appendSemicolon, camelToKebab, convertFileToBase64, createFormData, fillArray, formatDateAndTime, getRandomNumber, httpErrorCodeLookup, interpolateObjects, isLeapYear, isMonthlyMultiple, isOrdered, isSameDate, omitProperties, parseEmail, parseEnv, parseIntStrict, parseUUID, randomiseArray, range, removeDuplicates, stringListToArray, stringToBoolean, truncate, wait };
+export { APIError, type CreateFormDataOptions, type CreateFormDataOptionsNullableResolution, type CreateFormDataOptionsUndefinedOrNullResolution, type DisallowUndefined, type Email, type Env, type FormDataNullableResolutionStrategy as FormDataResolutionStrategy, type HTTPErrorCode, type HTTPErrorCodes, type NonUndefined, type OptionalOnCondition, type RecordKey, type StringListToArrayOptions, type UUID, addDaysToDate, appendSemicolon, camelToKebab, convertFileToBase64, createFormData, fillArray, formatDateAndTime, getRandomNumber, httpErrorCodeLookup, interpolateObjects, isLeapYear, isMonthlyMultiple, isOrdered, isSameDate, omitProperties, parseEmail, parseEnv, parseIntStrict, parseUUID, randomiseArray, range, removeDuplicates, stringListToArray, stringToBoolean, truncate, wait };

package/dist/index.js

@@ -63,15 +63,19 @@ function convertFileToBase64(file) {
 var convertFileToBase64_default = convertFileToBase64;
 
 // src/functions/createFormData.ts
-function createFormData(data, options = { nullableResolution: "empty" }) {
+function getNullableResolutionStrategy(key, strategy) {
+  var _a;
+  return (_a = typeof strategy === "object" ? strategy[key] : strategy) != null ? _a : "empty";
+}
+function createFormData(data, options = { arrayResolution: "stringify", nullableResolution: "empty" }) {
   const formData = new FormData();
-  function resolveByStrategy(key, value, resolutionStrategy) {
+  function resolveNullablesByStrategy(key, value, resolutionStrategy) {
     switch (resolutionStrategy) {
       case "empty":
-        formData.append(key, "");
+        formData.append(String(key), "");
         break;
       case "stringify":
-        formData.append(key, JSON.stringify(value));
+        formData.append(String(key), JSON.stringify(value));
         break;
       case "omit":
         break;
@@ -79,28 +83,52 @@ function createFormData(data, options = { nullableResolution: "empty" }) {
         throw new TypeError("SLOPPY_PURE_JAVASCRIPT_USER_ERROR");
     }
   }
-  for (const key in data) {
-    if (data[key] instanceof Blob) {
-      formData.append(key, data[key]);
-    } else if (data[key] === void 0 || data[key] === null) {
-      if (options.nullableResolution) {
-        resolveByStrategy(key, data[key], options.nullableResolution);
-        continue;
+  function resolveNullables(key, value, options2) {
+    if (options2.nullableResolution) {
+      resolveNullablesByStrategy(
+        key,
+        value,
+        getNullableResolutionStrategy(key, options2.nullableResolution)
+      );
+      return;
+    }
+    if (options2.undefinedResolution || options2.nullResolution) {
+      if (data[key] === void 0 && options2.undefinedResolution) {
+        resolveNullablesByStrategy(
+          key,
+          value,
+          getNullableResolutionStrategy(key, options2.undefinedResolution)
+        );
+        return;
       }
-      if (options.undefinedResolution || options.nullResolution) {
-        if (data[key] === void 0 && options.undefinedResolution) {
-          resolveByStrategy(key, data[key], options.undefinedResolution);
-          continue;
-        }
-        if (data[key] === null && options.nullResolution) {
-          resolveByStrategy(key, data[key], options.nullResolution);
-          continue;
+      if (data[key] === null && options2.nullResolution) {
+        resolveNullablesByStrategy(
+          key,
+          value,
+          getNullableResolutionStrategy(key, options2.nullResolution)
+        );
+      }
+    }
+  }
+  const entries = Object.entries(data);
+  for (const [key, value] of entries) {
+    if (value instanceof Blob) {
+      formData.append(String(key), value);
+    } else if (value === void 0 || value === null) {
+      resolveNullables(key, value, options);
+    } else if (typeof value === "object") {
+      if (Array.isArray(value) && (options.arrayResolution === "multiple" || typeof options.arrayResolution === "object" && options.arrayResolution[key] === "multiple")) {
+        for (const item of value) {
+          if ((typeof item === "object" || !item) && !(item instanceof Blob)) {
+            throw new TypeError("NON_PRIMITIVE_ARRAY_ITEMS_FOUND");
+          }
+          formData.append(String(key), String(item));
         }
+        continue;
       }
-    } else if (typeof data[key] === "object") {
-      formData.append(key, JSON.stringify(data[key]));
+      formData.append(String(key), JSON.stringify(value));
     } else {
-      formData.append(key, String(data[key]));
+      formData.append(String(key), String(value));
     }
   }
   return formData;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alextheman/utility",
-  "version": "2.11.0",
+  "version": "2.12.0",
   "description": "Helpful utility functions",
   "license": "ISC",
   "author": "alextheman",