@beabee/beabee-common 0.21.1-alpha.2 → 0.44.2

package/dist/utils/callouts.js

@@ -0,0 +1,186 @@
+import { CalloutComponentBaseType, CalloutComponentType, calloutComponentInputSelectableTypes, calloutComponentInputTextTypes, calloutComponentInputTypes, calloutComponentNestableTypes, } from '../data/index.js';
+function convertValuesToOptions(values) {
+    return values.map(({ value }) => value);
+}
+function convertComponentToFilter(component) {
+    const baseItem = {
+        label: component.label || component.fullKey,
+        nullable: true,
+    };
+    if (isCalloutComponentOfType(component, CalloutComponentType.INPUT_CHECKBOX)) {
+        return { ...baseItem, type: 'boolean', nullable: false };
+    }
+    if (isCalloutComponentOfType(component, CalloutComponentType.INPUT_NUMBER)) {
+        return { ...baseItem, type: 'number' };
+    }
+    if (isCalloutComponentOfType(component, CalloutComponentType.INPUT_SELECT)) {
+        return {
+            ...baseItem,
+            type: 'enum',
+            options: convertValuesToOptions(component.data.values),
+        };
+    }
+    if (isCalloutComponentOfBaseType(component, CalloutComponentBaseType.INPUT_SELECTABLE)) {
+        return {
+            ...baseItem,
+            type: component.type === CalloutComponentType.INPUT_SELECTABLE_RADIO
+                ? 'enum'
+                : 'array',
+            options: convertValuesToOptions(component.values),
+        };
+    }
+    if (isCalloutComponentOfType(component, CalloutComponentType.INPUT_TEXT_AREA)) {
+        return { ...baseItem, type: 'blob' };
+    }
+    return { ...baseItem, type: 'text' };
+}
+function getSelectableLabelFromValue(component, value) {
+    if (isCalloutComponentOfBaseType(component, CalloutComponentBaseType.INPUT_SELECTABLE)) {
+        return component.values.find((v) => v.value === value)?.label || value;
+    }
+    if (isCalloutComponentOfType(component, CalloutComponentType.INPUT_SELECT)) {
+        return component.data.values.find((v) => v.value === value)?.label || value;
+    }
+    return value;
+}
+/**
+ * Check if a component is a specific component type
+ *
+ * @param component The component to check
+ * @param type The type of component to check
+ * @returns Ensure that the component is of the specific type
+ */
+export function isCalloutComponentOfType(component, type) {
+    return 'type' in component && component.type === type;
+}
+/**
+ * Check if a component is a specific base component type
+ *
+ * @param component The component to check
+ * @param type The type of component to check
+ * @returns Ensure that the component is of the specific base type
+ */
+export function isCalloutComponentOfBaseType(component, type) {
+    if (!('type' in component)) {
+        return false;
+    }
+    // `content` has only one schema
+    if (type === CalloutComponentBaseType.CONTENT) {
+        return isCalloutComponentOfType(component, CalloutComponentType.CONTENT);
+    }
+    if (type === CalloutComponentBaseType.INPUT) {
+        return calloutComponentInputTypes.includes(component.type);
+    }
+    if (type === CalloutComponentBaseType.INPUT_TEXT) {
+        return calloutComponentInputTextTypes.includes(component.type);
+    }
+    if (type === CalloutComponentBaseType.INPUT_SELECTABLE) {
+        return calloutComponentInputSelectableTypes.includes(component.type);
+    }
+    if (type === CalloutComponentBaseType.NESTABLE) {
+        return calloutComponentNestableTypes.includes(component.type);
+    }
+    return false;
+}
+export function flattenComponents(components) {
+    return components.flatMap((component) => isCalloutComponentOfBaseType(component, CalloutComponentBaseType.NESTABLE)
+        ? [component, ...flattenComponents(component.components)]
+        : [component]);
+}
+export function filterComponents(components, filterFn) {
+    return components.filter(filterFn).map((component) => {
+        return {
+            ...component,
+            ...(isCalloutComponentOfBaseType(component, CalloutComponentBaseType.NESTABLE) && {
+                components: filterComponents(component.components, filterFn),
+            }),
+        };
+    });
+}
+export function getCalloutComponents(formSchema) {
+    return formSchema.slides.flatMap((slide) => flattenComponents(slide.components).map((component) => ({
+        ...component,
+        slideId: slide.id,
+        fullKey: `${slide.id}.${component.key}`,
+    })));
+}
+export function getCalloutFilters(formSchema) {
+    const items = getCalloutComponents(formSchema)
+        .filter((c) => c.input)
+        .map((c) => [`answers.${c.fullKey}`, convertComponentToFilter(c)]);
+    return Object.fromEntries(items);
+}
+export function isAddressAnswer(answer) {
+    return !!answer && typeof answer === 'object' && 'geometry' in answer;
+}
+export function isFileUploadAnswer(answer) {
+    return !!answer && typeof answer === 'object' && 'url' in answer;
+}
+export function isFormioFileAnswer(answer) {
+    return (!!answer &&
+        typeof answer === 'object' &&
+        'url' in answer &&
+        'storage' in answer &&
+        'name' in answer &&
+        'size' in answer
+    // Not defined on old files
+    // "hash" in answer &&
+    // "originalName" in answer
+    );
+}
+export function stringifyAnswer(component, answer) {
+    if (Array.isArray(answer)) {
+        return answer.map((a) => stringifyAnswer(component, a)).join(', ');
+    }
+    else if (!answer) {
+        return '';
+    }
+    else if (isAddressAnswer(answer)) {
+        return JSON.stringify(answer);
+    }
+    else if (isFileUploadAnswer(answer)) {
+        return answer.url;
+    }
+    else if (typeof answer === 'object') {
+        // Checkboxes
+        return Object.entries(answer)
+            .filter(([, selected]) => selected)
+            .map(([value]) => getSelectableLabelFromValue(component, value))
+            .join(', ');
+    }
+    else if (typeof answer === 'string') {
+        return getSelectableLabelFromValue(component, answer);
+    }
+    else {
+        return answer.toString();
+    }
+}
+/**
+ * Retrieves the value at a given path of a nested object, similar to lodash's `get` function.
+ *
+ * @param {object} obj - The object to query.
+ * @param {string} path - The path of the property to get, using dot notation (e.g., "a.b.c").
+ * @returns {unknown} - Returns the resolved value, or `undefined` if the path does not exist.
+ *
+ * @example
+ * // Example with a generic object:
+ * const data = { a: { b: { c: 42 } } };
+ * const value = getByPath(data, 'a.b.c');
+ * // value === 42
+ *
+ * // Example with a callout response object:
+ * const calloutResponse = {
+ *   answers: {
+ *     'slide1.input1': 'some answer',
+ *     'slide2.input2': 123
+ *   }
+ * };
+ * const answer = getByPath(calloutResponse, 'answers.slide1.input1');
+ * // answer === 'some answer'
+ */
+export function getByPath(obj, path) {
+    return path
+        .split('.')
+        .reduce((acc, key) => (acc && key in acc ? acc[key] : undefined), obj);
+}
+//# sourceMappingURL=callouts.js.map

package/dist/utils/callouts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"callouts.js","sourceRoot":"","sources":["../../src/utils/callouts.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,oBAAoB,EACpB,oCAAoC,EACpC,8BAA8B,EAC9B,0BAA0B,EAC1B,6BAA6B,GAC9B,MAAM,kBAAkB,CAAC;AAe1B,SAAS,sBAAsB,CAC7B,MAA0C;IAE1C,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC;AAC1C,CAAC;AAED,SAAS,wBAAwB,CAC/B,SAAuD;IAEvD,MAAM,QAAQ,GAAG;QACf,KAAK,EAAE,SAAS,CAAC,KAAK,IAAI,SAAS,CAAC,OAAO;QAC3C,QAAQ,EAAE,IAAI;KACf,CAAC;IAEF,IACE,wBAAwB,CAAC,SAAS,EAAE,oBAAoB,CAAC,cAAc,CAAC,EACxE,CAAC;QACD,OAAO,EAAE,GAAG,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;IAC3D,CAAC;IAED,IAAI,wBAAwB,CAAC,SAAS,EAAE,oBAAoB,CAAC,YAAY,CAAC,EAAE,CAAC;QAC3E,OAAO,EAAE,GAAG,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IACzC,CAAC;IAED,IAAI,wBAAwB,CAAC,SAAS,EAAE,oBAAoB,CAAC,YAAY,CAAC,EAAE,CAAC;QAC3E,OAAO;YACL,GAAG,QAAQ;YACX,IAAI,EAAE,MAAM;YACZ,OAAO,EAAE,sBAAsB,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC;SACvD,CAAC;IACJ,CAAC;IAED,IACE,4BAA4B,CAC1B,SAAS,EACT,wBAAwB,CAAC,gBAAgB,CAC1C,EACD,CAAC;QACD,OAAO;YACL,GAAG,QAAQ;YACX,IAAI,EACF,SAAS,CAAC,IAAI,KAAK,oBAAoB,CAAC,sBAAsB;gBAC5D,CAAC,CAAC,MAAM;gBACR,CAAC,CAAC,OAAO;YACb,OAAO,EAAE,sBAAsB,CAAC,SAAS,CAAC,MAAM,CAAC;SAClD,CAAC;IACJ,CAAC;IAED,IACE,wBAAwB,CAAC,SAAS,EAAE,oBAAoB,CAAC,eAAe,CAAC,EACzE,CAAC;QACD,OAAO,EAAE,GAAG,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IACvC,CAAC;IAED,OAAO,EAAE,GAAG,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;AACvC,CAAC;AAED,SAAS,2BAA2B,CAClC,SAAiC,EACjC,KAAa;IAEb,IACE,4BAA4B,CAC1B,SAAS,EACT,wBAAwB,CAAC,gBAAgB,CAC1C,EACD,CAAC;QACD,OAAO,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC,EAAE,KAAK,IAAI,KAAK,CAAC;IACzE,CAAC;IAED,IAAI,wBAAwB,CAAC,SAAS,EAAE,oBAAoB,CAAC,YAAY,CAAC,EAAE,CAAC;QAC3E,OAAO,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC,EAAE,KAAK,IAAI,KAAK,CAAC;IAC9E,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,wBAAwB,CACtC,SAAqC,EACrC,IAAO;IAEP,OAAO,MAAM,IAAI,SAAS,IAAI,SAAS,CAAC,IAAI,KAAK,IAAI,CAAC;AACxD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,4BAA4B,CAG1C,SAAqC,EACrC,IAAO;IAEP,IAAI,CAAC,CAAC,MAAM,IAAI,SAAS,CAAC,EAAE,CAAC;QAC3B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,gCAAgC;IAChC,IAAI,IAAI,KAAK,wBAAwB,CAAC,OAAO,EAAE,CAAC;QAC9C,OAAO,wBAAwB,CAAC,SAAS,EAAE,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAC3E,CAAC;IAED,IAAI,IAAI,KAAK,wBAAwB,CAAC,KAAK,EAAE,CAAC;QAC5C,OAAQ,0BAAuC,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAC3E,CAAC;IAED,IAAI,IAAI,KAAK,wBAAwB,CAAC,UAAU,EAAE,CAAC;QACjD,OAAQ,8BAA2C,CAAC,QAAQ,CAC1D,SAAS,CAAC,IAAI,CACf,CAAC;IACJ,CAAC;IAED,IAAI,IAAI,KAAK,wBAAwB,CAAC,gBAAgB,EAAE,CAAC;QACvD,OAAQ,oCAAiD,CAAC,QAAQ,CAChE,SAAS,CAAC,IAAI,CACf,CAAC;IACJ,CAAC;IAED,IAAI,IAAI,KAAK,wBAAwB,CAAC,QAAQ,EAAE,CAAC;QAC/C,OAAQ,6BAA0C,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAC9E,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,UAAoC;IAEpC,OAAO,UAAU,CAAC,OAAO,CAAC,CAAC,SAAS,EAAE,EAAE,CACtC,4BAA4B,CAAC,SAAS,EAAE,wBAAwB,CAAC,QAAQ,CAAC;QACxE,CAAC,CAAC,CAAC,SAAS,EAAE,GAAG,iBAAiB,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;QACzD,CAAC,CAAC,CAAC,SAAS,CAAC,CAChB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,UAAoC,EACpC,QAAwD;IAExD,OAAO,UAAU,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE;QACnD,OAAO;YACL,GAAG,SAAS;YACZ,GAAG,CAAC,4BAA4B,CAC9B,SAAS,EACT,wBAAwB,CAAC,QAAQ,CAClC,IAAI;gBACH,UAAU,EAAE,gBAAgB,CAAC,SAAS,CAAC,UAAU,EAAE,QAAQ,CAAC;aAC7D,CAAC;SACH,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,UAAgC;IAEhC,OAAO,UAAU,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CACzC,iBAAiB,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QACtD,GAAG,SAAS;QACZ,OAAO,EAAE,KAAK,CAAC,EAAE;QACjB,OAAO,EAAE,GAAG,KAAK,CAAC,EAAE,IAAI,SAAS,CAAC,GAAG,EAAE;KACxC,CAAC,CAAC,CACJ,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,UAAgC;IAEhC,MAAM,KAAK,GAAG,oBAAoB,CAAC,UAAU,CAAC;SAC3C,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;SACtB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,OAAO,EAAE,EAAE,wBAAwB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAErE,OAAO,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,MAA6B;IAE7B,OAAO,CAAC,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,UAAU,IAAI,MAAM,CAAC;AACxE,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,MAAyC;IAEzC,OAAO,CAAC,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,KAAK,IAAI,MAAM,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,MAAyC;IAEzC,OAAO,CACL,CAAC,CAAC,MAAM;QACR,OAAO,MAAM,KAAK,QAAQ;QAC1B,KAAK,IAAI,MAAM;QACf,SAAS,IAAI,MAAM;QACnB,MAAM,IAAI,MAAM;QAChB,MAAM,IAAI,MAAM;IAChB,2BAA2B;IAC3B,sBAAsB;IACtB,2BAA2B;KAC5B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,SAAiC,EACjC,MAAmE;IAEnE,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1B,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACrE,CAAC;SAAM,IAAI,CAAC,MAAM,EAAE,CAAC;QACnB,OAAO,EAAE,CAAC;IACZ,CAAC;SAAM,IAAI,eAAe,CAAC,MAAM,CAAC,EAAE,CAAC;QACnC,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAChC,CAAC;SAAM,IAAI,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAAC;QACtC,OAAO,MAAM,CAAC,GAAG,CAAC;IACpB,CAAC;SAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QACtC,aAAa;QACb,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC;aAC1B,MAAM,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC;aAClC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,2BAA2B,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;aAC/D,IAAI,CAAC,IAAI,CAAC,CAAC;IAChB,CAAC;SAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QACtC,OAAO,2BAA2B,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IACxD,CAAC;SAAM,CAAC;QACN,OAAO,MAAM,CAAC,QAAQ,EAAE,CAAC;IAC3B,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,SAAS,CACvB,GAAM,EACN,IAAY;IAEZ,OAAO,IAAI;SACR,KAAK,CAAC,GAAG,CAAC;SACV,MAAM,CAAM,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,IAAI,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,GAAG,CAAC,CAAC;AAChF,CAAC"}

package/dist/utils/conversions.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Convert the value to a valid phone number
+ * @param value The value to convert
+ * @returns The valid phone number or null if the value is not a valid phone number
+ */
+export declare const toPhoneNumber: (value: unknown) => string | false;
+/**
+ * Convert the value to a valid bytes number.
+ * Note: This method ignores the text case of the unit, so b is always the same as B which means Byte and makes no different between Bytes and bits.
+ * This method can be used to convert `fileMinSize` and `fileMaxSize` of a callout file component to bytes.
+ * @param value E.g. "0KB", "1GB"
+ * @returns The valid bytes number or null if the value is not a valid bytes number.
+ */
+export declare const toBytes: (value: unknown) => number | null;
+//# sourceMappingURL=conversions.d.ts.map

package/dist/utils/conversions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversions.d.ts","sourceRoot":"","sources":["../../src/utils/conversions.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,eAAO,MAAM,aAAa,GAAI,OAAO,OAAO,KAAG,MAAM,GAAG,KASvD,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,OAAO,GAAI,OAAO,OAAO,KAAG,MAAM,GAAG,IAcjD,CAAC"}

package/dist/utils/conversions.js

@@ -0,0 +1,37 @@
+import { isPhoneNumber } from './validations.js';
+/**
+ * Convert the value to a valid phone number
+ * @param value The value to convert
+ * @returns The valid phone number or null if the value is not a valid phone number
+ */
+export const toPhoneNumber = (value) => {
+    if (typeof value !== 'string' || !value.length) {
+        return false;
+    }
+    const result = value.replace(/(?!^\+)\D/g, '');
+    if (!isPhoneNumber(result)) {
+        return false;
+    }
+    return result;
+};
+/**
+ * Convert the value to a valid bytes number.
+ * Note: This method ignores the text case of the unit, so b is always the same as B which means Byte and makes no different between Bytes and bits.
+ * This method can be used to convert `fileMinSize` and `fileMaxSize` of a callout file component to bytes.
+ * @param value E.g. "0KB", "1GB"
+ * @returns The valid bytes number or null if the value is not a valid bytes number.
+ */
+export const toBytes = (value) => {
+    if (typeof value !== 'string' || !value.length) {
+        return null;
+    }
+    const lowerCase = value.toLowerCase();
+    const units = ['b', 'kb', 'mb', 'gb', 'tb', 'pb', 'eb', 'zb', 'yb'];
+    const [, num, unit] = lowerCase.match(/(\d+)(\w+)/);
+    const unitIndex = units.indexOf(unit.toLowerCase());
+    if (unitIndex === -1) {
+        return null;
+    }
+    return Number(num) * Math.pow(1024, unitIndex);
+};
+//# sourceMappingURL=conversions.js.map

package/dist/utils/conversions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversions.js","sourceRoot":"","sources":["../../src/utils/conversions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,KAAc,EAAkB,EAAE;IAC9D,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;QAC/C,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;IAC/C,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,KAAc,EAAiB,EAAE;IACvD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;QAC/C,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,SAAS,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;IACtC,MAAM,KAAK,GAAG,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IACpE,MAAM,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,SAAS,CAAC,KAAK,CAAC,YAAY,CAAE,CAAC;IACrD,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;IAEpD,IAAI,SAAS,KAAK,CAAC,CAAC,EAAE,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;AACjD,CAAC,CAAC"}

package/dist/utils/date.d.ts

@@ -0,0 +1,9 @@
+import type { DateUnit, Duration } from '../types/index.js';
+export declare const dateUnits: readonly ["s", "m", "h", "d", "M", "y"];
+export declare const dateUnitMap: Record<DateUnit, keyof Duration>;
+export declare function parseDate(value: string, now?: Date): [Date, DateUnit];
+export declare function getMinDateUnit(units: [DateUnit, ...DateUnit[]]): DateUnit;
+export declare function getMinDateUnit(units: DateUnit[]): DateUnit | undefined;
+export declare function isValidDate(s: string | Date): boolean;
+export declare function isDateBetween(date: string | Date, start?: string | Date | null, end?: string | Date | null): boolean;
+//# sourceMappingURL=date.d.ts.map

package/dist/utils/date.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"date.d.ts","sourceRoot":"","sources":["../../src/utils/date.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAe,MAAM,mBAAmB,CAAC;AAGzE,eAAO,MAAM,SAAS,yCAA0C,CAAC;AAEjE,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,QAAQ,CAOxD,CAAC;AAqBF,wBAAgB,SAAS,CACvB,KAAK,EAAE,MAAM,EACb,GAAG,GAAE,IAAiB,GACrB,CAAC,IAAI,EAAE,QAAQ,CAAC,CA2BlB;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,GAAG,QAAQ,EAAE,CAAC,GAAG,QAAQ,CAAC;AAC3E,wBAAgB,cAAc,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,QAAQ,GAAG,SAAS,CAAC;AAKxE,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAKrD;AAED,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,GAAG,IAAI,EACnB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,EAC5B,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,GACzB,OAAO,CAWT"}

package/dist/utils/date.js

@@ -0,0 +1,76 @@
+import { add, isValid, parseISO, startOfDay, startOfHour, startOfMinute, startOfMonth, startOfSecond, startOfYear, } from 'date-fns';
+// Must be ordered from highest resolution to lowest (seconds to years)
+export const dateUnits = ['s', 'm', 'h', 'd', 'M', 'y'];
+export const dateUnitMap = {
+    y: 'years',
+    M: 'months',
+    d: 'days',
+    h: 'hours',
+    m: 'minutes',
+    s: 'seconds',
+};
+const startOf = {
+    y: startOfYear,
+    M: startOfMonth,
+    d: startOfDay,
+    h: startOfHour,
+    m: startOfMinute,
+    s: startOfSecond,
+};
+const relativeDate = /^\$now(?<units>\(((y|M|d|h|m|s):(-?\d+),?)+\))?$/;
+const relativeUnit = /(y|M|d|h|m|s):(-?\d+)/g;
+// Matches the different parts of an ISO 8601 date. Note we don't validate the
+// pattern properly as that is handled by parseISO, we just want to know which
+// parts of the date were specified
+const absoluteDate = /^(?<y>\d{4,})(-(?<M>\d\d)(-(?<d>\d\d)([T ](?<h>\d\d)(:(?<m>\d\d)(:(?<s>\d\d))?)?)?)?)?/;
+// Convert relative dates and returns the minimum date unit specified
+export function parseDate(value, now = new Date()) {
+    let date;
+    let units;
+    const relativeMatch = relativeDate.exec(value);
+    if (relativeMatch) {
+        date = now;
+        const unitsGroup = relativeMatch.groups?.units;
+        if (unitsGroup) {
+            const unitMatches = unitsGroup.matchAll(relativeUnit);
+            units = [];
+            for (const [_, unit, delta] of unitMatches) {
+                date = add(date, { [dateUnitMap[unit]]: Number(delta) });
+                units.push(unit);
+            }
+        }
+        else {
+            units = ['d'];
+        }
+    }
+    else {
+        date = parseISO(value);
+        units = Object.entries(absoluteDate.exec(value)?.groups || {})
+            .filter(([_, n]) => !!n)
+            .map(([unit]) => unit);
+    }
+    const minUnit = getMinDateUnit(units) || 's';
+    return [startOf[minUnit](date), minUnit];
+}
+export function getMinDateUnit(units) {
+    return dateUnits.find((unit) => units.includes(unit));
+}
+export function isValidDate(s) {
+    if (typeof s === 'string') {
+        return relativeDate.test(s) || isValid(parseISO(s));
+    }
+    return isValid(s);
+}
+export function isDateBetween(date, start, end) {
+    let valid = isValidDate(date);
+    if (start) {
+        start = typeof start === 'string' ? parseISO(start) : start;
+        valid = valid && date >= start;
+    }
+    if (end) {
+        end = typeof end === 'string' ? parseISO(end) : end;
+        valid = valid && date <= end;
+    }
+    return valid;
+}
+//# sourceMappingURL=date.js.map

package/dist/utils/date.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"date.js","sourceRoot":"","sources":["../../src/utils/date.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,GAAG,EACH,OAAO,EACP,QAAQ,EACR,UAAU,EACV,WAAW,EACX,aAAa,EACb,YAAY,EACZ,aAAa,EACb,WAAW,GACZ,MAAM,UAAU,CAAC;AAIlB,uEAAuE;AACvE,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAU,CAAC;AAEjE,MAAM,CAAC,MAAM,WAAW,GAAqC;IAC3D,CAAC,EAAE,OAAO;IACV,CAAC,EAAE,QAAQ;IACX,CAAC,EAAE,MAAM;IACT,CAAC,EAAE,OAAO;IACV,CAAC,EAAE,SAAS;IACZ,CAAC,EAAE,SAAS;CACb,CAAC;AAEF,MAAM,OAAO,GAAwC;IACnD,CAAC,EAAE,WAAW;IACd,CAAC,EAAE,YAAY;IACf,CAAC,EAAE,UAAU;IACb,CAAC,EAAE,WAAW;IACd,CAAC,EAAE,aAAa;IAChB,CAAC,EAAE,aAAa;CACjB,CAAC;AAEF,MAAM,YAAY,GAAG,kDAAkD,CAAC;AACxE,MAAM,YAAY,GAAG,wBAAwB,CAAC;AAE9C,8EAA8E;AAC9E,8EAA8E;AAC9E,mCAAmC;AACnC,MAAM,YAAY,GAChB,wFAAwF,CAAC;AAE3F,qEAAqE;AACrE,MAAM,UAAU,SAAS,CACvB,KAAa,EACb,MAAY,IAAI,IAAI,EAAE;IAEtB,IAAI,IAAU,CAAC;IACf,IAAI,KAAiB,CAAC;IAEtB,MAAM,aAAa,GAAG,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC/C,IAAI,aAAa,EAAE,CAAC;QAClB,IAAI,GAAG,GAAG,CAAC;QACX,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,EAAE,KAAK,CAAC;QAC/C,IAAI,UAAU,EAAE,CAAC;YACf,MAAM,WAAW,GAAG,UAAU,CAAC,QAAQ,CAAC,YAAY,CAAgB,CAAC;YACrE,KAAK,GAAG,EAAE,CAAC;YACX,KAAK,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,WAAW,EAAE,CAAC;gBAC3C,IAAI,GAAG,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;gBACzD,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACnB,CAAC;QACH,CAAC;aAAM,CAAC;YACN,KAAK,GAAG,CAAC,GAAG,CAAC,CAAC;QAChB,CAAC;IACH,CAAC;SAAM,CAAC;QACN,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;QACvB,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,MAAM,IAAI,EAAE,CAAC;aAC3D,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;aACvB,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,CAAe,CAAC;IACzC,CAAC;IAED,MAAM,OAAO,GAAG,cAAc,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC;IAC7C,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;AAC3C,CAAC;AAID,MAAM,UAAU,cAAc,CAAC,KAAiB;IAC9C,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,CAAgB;IAC1C,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;QAC1B,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IACtD,CAAC;IACD,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,aAAa,CAC3B,IAAmB,EACnB,KAA4B,EAC5B,GAA0B;IAE1B,IAAI,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IAC9B,IAAI,KAAK,EAAE,CAAC;QACV,KAAK,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QAC5D,KAAK,GAAG,KAAK,IAAI,IAAI,IAAI,KAAM,CAAC;IAClC,CAAC;IACD,IAAI,GAAG,EAAE,CAAC;QACR,GAAG,GAAG,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;QACpD,KAAK,GAAG,KAAK,IAAI,IAAI,IAAI,GAAI,CAAC;IAChC,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/utils/debounce.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Creates a debounced function that delays invoking the provided function
+ * until after the specified wait time has elapsed since the last time it was invoked.
+ *
+ * @param fn - The function to debounce
+ * @param wait - The number of milliseconds to delay
+ * @returns A debounced version of the function with a cancel method
+ */
+export declare function debounce<T extends (...args: any[]) => any>(fn: T, wait: number): ((...args: Parameters<T>) => void) & {
+    cancel: () => void;
+};
+/**
+ * Creates a throttled function that invokes the provided function at most once
+ * per specified wait time period.
+ *
+ * @param fn - The function to throttle
+ * @param wait - The number of milliseconds to wait between invocations
+ * @returns A throttled version of the function with a cancel method
+ */
+export declare function throttle<T extends (...args: any[]) => any>(fn: T, wait: number): ((...args: Parameters<T>) => void) & {
+    cancel: () => void;
+};
+//# sourceMappingURL=debounce.d.ts.map

package/dist/utils/debounce.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debounce.d.ts","sourceRoot":"","sources":["../../src/utils/debounce.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EACxD,EAAE,EAAE,CAAC,EACL,IAAI,EAAE,MAAM,GACX,CAAC,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,GAAG;IAAE,MAAM,EAAE,MAAM,IAAI,CAAA;CAAE,CAqB7D;AAED;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EACxD,EAAE,EAAE,CAAC,EACL,IAAI,EAAE,MAAM,GACX,CAAC,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,GAAG;IAAE,MAAM,EAAE,MAAM,IAAI,CAAA;CAAE,CA+B7D"}

package/dist/utils/debounce.js

@@ -0,0 +1,63 @@
+/**
+ * Creates a debounced function that delays invoking the provided function
+ * until after the specified wait time has elapsed since the last time it was invoked.
+ *
+ * @param fn - The function to debounce
+ * @param wait - The number of milliseconds to delay
+ * @returns A debounced version of the function with a cancel method
+ */
+export function debounce(fn, wait) {
+    let timeoutId = null;
+    const debounced = function (...args) {
+        if (timeoutId !== null) {
+            clearTimeout(timeoutId);
+        }
+        timeoutId = setTimeout(() => {
+            fn(...args);
+        }, wait);
+    };
+    debounced.cancel = () => {
+        if (timeoutId !== null) {
+            clearTimeout(timeoutId);
+            timeoutId = null;
+        }
+    };
+    return debounced;
+}
+/**
+ * Creates a throttled function that invokes the provided function at most once
+ * per specified wait time period.
+ *
+ * @param fn - The function to throttle
+ * @param wait - The number of milliseconds to wait between invocations
+ * @returns A throttled version of the function with a cancel method
+ */
+export function throttle(fn, wait) {
+    let lastCallTime = 0;
+    let timeoutId = null;
+    const throttled = function (...args) {
+        const now = Date.now();
+        const timeSinceLastCall = now - lastCallTime;
+        if (timeSinceLastCall >= wait) {
+            lastCallTime = now;
+            fn(...args);
+        }
+        else {
+            if (timeoutId !== null) {
+                clearTimeout(timeoutId);
+            }
+            timeoutId = setTimeout(() => {
+                lastCallTime = Date.now();
+                fn(...args);
+            }, wait - timeSinceLastCall);
+        }
+    };
+    throttled.cancel = () => {
+        if (timeoutId !== null) {
+            clearTimeout(timeoutId);
+            timeoutId = null;
+        }
+    };
+    return throttled;
+}
+//# sourceMappingURL=debounce.js.map

package/dist/utils/debounce.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debounce.js","sourceRoot":"","sources":["../../src/utils/debounce.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,UAAU,QAAQ,CACtB,EAAK,EACL,IAAY;IAEZ,IAAI,SAAS,GAAyC,IAAI,CAAC;IAE3D,MAAM,SAAS,GAAG,UAAU,GAAG,IAAmB;QAChD,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;YACvB,YAAY,CAAC,SAAS,CAAC,CAAC;QAC1B,CAAC;QAED,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE;YAC1B,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;QACd,CAAC,EAAE,IAAI,CAAC,CAAC;IACX,CAAC,CAAC;IAEF,SAAS,CAAC,MAAM,GAAG,GAAG,EAAE;QACtB,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;YACvB,YAAY,CAAC,SAAS,CAAC,CAAC;YACxB,SAAS,GAAG,IAAI,CAAC;QACnB,CAAC;IACH,CAAC,CAAC;IAEF,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,QAAQ,CACtB,EAAK,EACL,IAAY;IAEZ,IAAI,YAAY,GAAG,CAAC,CAAC;IACrB,IAAI,SAAS,GAAyC,IAAI,CAAC;IAE3D,MAAM,SAAS,GAAG,UAAU,GAAG,IAAmB;QAChD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,iBAAiB,GAAG,GAAG,GAAG,YAAY,CAAC;QAE7C,IAAI,iBAAiB,IAAI,IAAI,EAAE,CAAC;YAC9B,YAAY,GAAG,GAAG,CAAC;YACnB,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;QACd,CAAC;aAAM,CAAC;YACN,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;gBACvB,YAAY,CAAC,SAAS,CAAC,CAAC;YAC1B,CAAC;YAED,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC1B,YAAY,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;gBAC1B,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;YACd,CAAC,EAAE,IAAI,GAAG,iBAAiB,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC,CAAC;IAEF,SAAS,CAAC,MAAM,GAAG,GAAG,EAAE;QACtB,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;YACvB,YAAY,CAAC,SAAS,CAAC,CAAC;YACxB,SAAS,GAAG,IAAI,CAAC;QACnB,CAAC;IACH,CAAC,CAAC;IAEF,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/utils/file.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Check if a MIME type is a supported document type.
+ * Example: "application/pdf"
+ * @param mimetype MIME type to check
+ * @returns True if it's a supported document type
+ */
+export declare const isSupportedDocumentType: (mimetype?: string) => boolean;
+/**
+ * Check if an extension is a supported document extension.
+ * Example: "pdf"
+ * @param extension Extension to check
+ * @returns True if it's a supported document extension
+ */
+export declare const isSupportedDocumentExtension: (extension?: string) => boolean;
+/**
+ * Check if a MIME type is a supported image type.
+ * Example: "image/jpeg", "image/png", "image/webp", "image/avif"
+ * @param mimetype MIME type to check
+ * @returns True if it's a supported image type
+ */
+export declare const isSupportedImageType: (mimetype?: string) => boolean;
+/**
+ * Check if an extension is a supported image extension.
+ * Example: "jpg", "png", "webp", "avif"
+ * @param extension Extension to check
+ * @returns True if it's a supported image extension
+ */
+export declare const isSupportedImageExtension: (extension?: string) => boolean;
+/**
+ * Converts byte size to a human-readable string representation
+ *
+ * This function takes a size in bytes and converts it to a human-readable
+ * format with appropriate units (B, KB, MB, GB, TB). The result is formatted
+ * with two decimal places.
+ *
+ * @param bytes - The file size in bytes to convert
+ * @returns A formatted string with size and unit (e.g., "15.50 MB")
+ *
+ * @example
+ * ```ts
+ * bytesToHumanReadable(1500000); // "1.43 MB"
+ * bytesToHumanReadable(1024);    // "1.00 KB"
+ * ```
+ */
+export declare const bytesToHumanReadable: (bytes: number) => string;
+//# sourceMappingURL=file.d.ts.map

package/dist/utils/file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.d.ts","sourceRoot":"","sources":["../../src/utils/file.ts"],"names":[],"mappings":"AAOA;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,GAAI,WAAW,MAAM,KAAG,OAG3D,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,4BAA4B,GAAI,YAAY,MAAM,KAAG,OAGjE,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,GAAI,WAAW,MAAM,KAAG,OAGxD,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB,GAAI,YAAY,MAAM,KAAG,OAG9D,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,oBAAoB,GAAI,OAAO,MAAM,KAAG,MAWpD,CAAC"}

package/dist/utils/file.js

@@ -0,0 +1,72 @@
+import { ALLOWED_DOCUMENT_EXTENSIONS, ALLOWED_DOCUMENT_MIME_TYPES, ALLOWED_IMAGE_EXTENSIONS, ALLOWED_IMAGE_MIME_TYPES, } from '../constants.js';
+/**
+ * Check if a MIME type is a supported document type.
+ * Example: "application/pdf"
+ * @param mimetype MIME type to check
+ * @returns True if it's a supported document type
+ */
+export const isSupportedDocumentType = (mimetype) => {
+    if (!mimetype)
+        return false;
+    return ALLOWED_DOCUMENT_MIME_TYPES.includes(mimetype.toLowerCase().trim());
+};
+/**
+ * Check if an extension is a supported document extension.
+ * Example: "pdf"
+ * @param extension Extension to check
+ * @returns True if it's a supported document extension
+ */
+export const isSupportedDocumentExtension = (extension) => {
+    if (!extension)
+        return false;
+    return ALLOWED_DOCUMENT_EXTENSIONS.includes(extension.toLowerCase().trim());
+};
+/**
+ * Check if a MIME type is a supported image type.
+ * Example: "image/jpeg", "image/png", "image/webp", "image/avif"
+ * @param mimetype MIME type to check
+ * @returns True if it's a supported image type
+ */
+export const isSupportedImageType = (mimetype) => {
+    if (!mimetype)
+        return false;
+    return ALLOWED_IMAGE_MIME_TYPES.includes(mimetype.toLowerCase().trim());
+};
+/**
+ * Check if an extension is a supported image extension.
+ * Example: "jpg", "png", "webp", "avif"
+ * @param extension Extension to check
+ * @returns True if it's a supported image extension
+ */
+export const isSupportedImageExtension = (extension) => {
+    if (!extension)
+        return false;
+    return ALLOWED_IMAGE_EXTENSIONS.includes(extension.toLowerCase().trim());
+};
+/**
+ * Converts byte size to a human-readable string representation
+ *
+ * This function takes a size in bytes and converts it to a human-readable
+ * format with appropriate units (B, KB, MB, GB, TB). The result is formatted
+ * with two decimal places.
+ *
+ * @param bytes - The file size in bytes to convert
+ * @returns A formatted string with size and unit (e.g., "15.50 MB")
+ *
+ * @example
+ * ```ts
+ * bytesToHumanReadable(1500000); // "1.43 MB"
+ * bytesToHumanReadable(1024);    // "1.00 KB"
+ * ```
+ */
+export const bytesToHumanReadable = (bytes) => {
+    const units = ['B', 'KB', 'MB', 'GB', 'TB'];
+    let index = 0;
+    let value = bytes;
+    while (value >= 1024 && index < units.length - 1) {
+        value /= 1024;
+        index++;
+    }
+    return `${value.toFixed(2)} ${units[index]}`;
+};
+//# sourceMappingURL=file.js.map

package/dist/utils/file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.js","sourceRoot":"","sources":["../../src/utils/file.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,2BAA2B,EAC3B,2BAA2B,EAC3B,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,iBAAiB,CAAC;AAEzB;;;;;GAKG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,QAAiB,EAAW,EAAE;IACpE,IAAI,CAAC,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5B,OAAO,2BAA2B,CAAC,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;AAC7E,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,SAAkB,EAAW,EAAE;IAC1E,IAAI,CAAC,SAAS;QAAE,OAAO,KAAK,CAAC;IAC7B,OAAO,2BAA2B,CAAC,QAAQ,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;AAC9E,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,QAAiB,EAAW,EAAE;IACjE,IAAI,CAAC,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5B,OAAO,wBAAwB,CAAC,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;AAC1E,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,SAAkB,EAAW,EAAE;IACvE,IAAI,CAAC,SAAS;QAAE,OAAO,KAAK,CAAC;IAC7B,OAAO,wBAAwB,CAAC,QAAQ,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;AAC3E,CAAC,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,KAAa,EAAU,EAAE;IAC5D,MAAM,KAAK,GAAG,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IAC5C,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,KAAK,GAAG,KAAK,CAAC;IAElB,OAAO,KAAK,IAAI,IAAI,IAAI,KAAK,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACjD,KAAK,IAAI,IAAI,CAAC;QACd,KAAK,EAAE,CAAC;IACV,CAAC;IAED,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;AAC/C,CAAC,CAAC"}

package/dist/utils/index.d.ts

@@ -0,0 +1,11 @@
+export * from './callouts.js';
+export * from './conversions.js';
+export * from './date.js';
+export * from './debounce.js';
+export * from './file.js';
+export * from './payments.js';
+export * from './rules.js';
+export * from './slug.js';
+export * from './url.js';
+export * from './validations.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AACA,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,kBAAkB,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,12 @@
+// Auto-generated by `@beabee/dev-cli generate-index`. Do not edit by hand.
+export * from './callouts.js';
+export * from './conversions.js';
+export * from './date.js';
+export * from './debounce.js';
+export * from './file.js';
+export * from './payments.js';
+export * from './rules.js';
+export * from './slug.js';
+export * from './url.js';
+export * from './validations.js';
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,kBAAkB,CAAC"}

package/dist/utils/payments.d.ts

@@ -0,0 +1,3 @@
+import type { Feeable, StripeFeeCountry } from '../types/index.js';
+export declare function calcPaymentFee(feeable: Feeable, country: StripeFeeCountry): number;
+//# sourceMappingURL=payments.d.ts.map

package/dist/utils/payments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payments.d.ts","sourceRoot":"","sources":["../../src/utils/payments.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AA6BnE,wBAAgB,cAAc,CAC5B,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,gBAAgB,GACxB,MAAM,CAiBR"}