@orion-js/helpers 3.11.15 → 4.0.0-alpha.3

package/lib/composeMiddlewares.d.ts

@@ -1,6 +0,0 @@
-/**
- * Compose `middleware` returning
- * a fully valid middleware comprised
- * of all those which are passed.
- */
-export declare function composeMiddlewares(middleware: any): (context: any, next?: any) => Promise<any>;

package/lib/composeMiddlewares.js

@@ -1,44 +0,0 @@
-"use strict";
-// from https://github.com/koajs/compose/blob/master/index.js
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.composeMiddlewares = void 0;
-/**
- * Compose `middleware` returning
- * a fully valid middleware comprised
- * of all those which are passed.
- */
-function composeMiddlewares(middleware) {
-    if (!Array.isArray(middleware))
-        throw new TypeError('Middleware stack must be an array!');
-    for (const fn of middleware) {
-        if (typeof fn !== 'function')
-            throw new TypeError('Middleware must be composed of functions!');
-    }
-    /**
-     * @param {Object} context
-     * @return {Promise}
-     * @api public
-     */
-    return function (context, next) {
-        // last called middleware #
-        let index = -1;
-        return dispatch(0);
-        function dispatch(i) {
-            if (i <= index)
-                return Promise.reject(new Error('next() called multiple times'));
-            index = i;
-            let fn = middleware[i];
-            if (i === middleware.length)
-                fn = next;
-            if (!fn)
-                return Promise.resolve();
-            try {
-                return Promise.resolve(fn(context, dispatch.bind(null, i + 1)));
-            }
-            catch (err) {
-                return Promise.reject(err);
-            }
-        }
-    };
-}
-exports.composeMiddlewares = composeMiddlewares;

package/lib/createMap.d.ts

@@ -1,17 +0,0 @@
-/**
- * Creates a map (object) from an array of items, using a specified property as the key.
- *
- * This utility transforms an array of objects into a lookup object/dictionary where
- * each item in the array becomes a value in the map, indexed by the specified property.
- * If multiple items have the same key value, only the last one will be preserved.
- *
- * @template T The type of items in the input array
- * @param array - The input array of items to transform into a map
- * @param key - The property name to use as keys in the resulting map (defaults to '_id')
- * @returns A record object where keys are values of the specified property and values are the original items
- *
- * @example
- * // Returns { '1': { id: 1, name: 'Item 1' }, '2': { id: 2, name: 'Item 2' } }
- * createMap([{ id: 1, name: 'Item 1' }, { id: 2, name: 'Item 2' }], 'id')
- */
-export default function createMap<T>(array: Array<T>, key?: string): Record<string, T>;

package/lib/createMap.js

@@ -1,26 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-/**
- * Creates a map (object) from an array of items, using a specified property as the key.
- *
- * This utility transforms an array of objects into a lookup object/dictionary where
- * each item in the array becomes a value in the map, indexed by the specified property.
- * If multiple items have the same key value, only the last one will be preserved.
- *
- * @template T The type of items in the input array
- * @param array - The input array of items to transform into a map
- * @param key - The property name to use as keys in the resulting map (defaults to '_id')
- * @returns A record object where keys are values of the specified property and values are the original items
- *
- * @example
- * // Returns { '1': { id: 1, name: 'Item 1' }, '2': { id: 2, name: 'Item 2' } }
- * createMap([{ id: 1, name: 'Item 1' }, { id: 2, name: 'Item 2' }], 'id')
- */
-function createMap(array, key = '_id') {
-    const map = {};
-    for (const item of array) {
-        map[item[key]] = item;
-    }
-    return map;
-}
-exports.default = createMap;

package/lib/createMap.test.d.ts

@@ -1 +0,0 @@
-export {};

package/lib/createMap.test.js

@@ -1,74 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-const createMap_1 = __importDefault(require("./createMap"));
-describe('createMap', () => {
-    it('should create a map using the default _id key', () => {
-        const array = [
-            { _id: '1', name: 'Item 1' },
-            { _id: '2', name: 'Item 2' },
-            { _id: '3', name: 'Item 3' }
-        ];
-        const result = (0, createMap_1.default)(array);
-        expect(result).toEqual({
-            '1': { _id: '1', name: 'Item 1' },
-            '2': { _id: '2', name: 'Item 2' },
-            '3': { _id: '3', name: 'Item 3' }
-        });
-    });
-    it('should create a map using a custom key', () => {
-        const array = [
-            { id: 'a', name: 'Item A' },
-            { id: 'b', name: 'Item B' },
-            { id: 'c', name: 'Item C' }
-        ];
-        const result = (0, createMap_1.default)(array, 'id');
-        expect(result).toEqual({
-            'a': { id: 'a', name: 'Item A' },
-            'b': { id: 'b', name: 'Item B' },
-            'c': { id: 'c', name: 'Item C' }
-        });
-    });
-    it('should handle empty arrays', () => {
-        const result = (0, createMap_1.default)([]);
-        expect(result).toEqual({});
-    });
-    it('should handle objects with property references', () => {
-        const array = [
-            { id: 'u1', message: 'Hello' },
-            { id: 'u2', message: 'World' }
-        ];
-        const result = (0, createMap_1.default)(array, 'id');
-        expect(result).toEqual({
-            'u1': { id: 'u1', message: 'Hello' },
-            'u2': { id: 'u2', message: 'World' }
-        });
-    });
-    it('should overwrite items with duplicate keys', () => {
-        const array = [
-            { id: 'dup', value: 'First' },
-            { id: 'dup', value: 'Second' },
-            { id: 'dup', value: 'Third' }
-        ];
-        const result = (0, createMap_1.default)(array, 'id');
-        // Only the last item with a given key should be preserved
-        expect(result).toEqual({
-            'dup': { id: 'dup', value: 'Third' }
-        });
-    });
-    it('should handle various key types', () => {
-        const array = [
-            { key: 1, value: 'Number key' },
-            { key: 'string', value: 'String key' },
-            { key: true, value: 'Boolean key' }
-        ];
-        const result = (0, createMap_1.default)(array, 'key');
-        expect(result).toEqual({
-            '1': { key: 1, value: 'Number key' },
-            'string': { key: 'string', value: 'String key' },
-            'true': { key: true, value: 'Boolean key' }
-        });
-    });
-});

package/lib/createMapArray.d.ts

@@ -1,22 +0,0 @@
-/**
- * Creates a grouped map from an array of items, using a specified property as the key.
- *
- * This utility transforms an array of objects into a lookup object/dictionary where
- * each value is an array of items sharing the same key value. Unlike createMap,
- * this function preserves all items with the same key by grouping them in arrays.
- *
- * @template T The type of items in the input array
- * @param array - The input array of items to transform into a grouped map
- * @param key - The property name to use as keys in the resulting map (defaults to '_id')
- * @returns A record object where keys are values of the specified property and values are arrays of items
- *
- * @example
- * // Returns { 'category1': [{ id: 1, category: 'category1' }, { id: 3, category: 'category1' }],
- * //           'category2': [{ id: 2, category: 'category2' }] }
- * createMapArray([
- *   { id: 1, category: 'category1' },
- *   { id: 2, category: 'category2' },
- *   { id: 3, category: 'category1' }
- * ], 'category')
- */
-export default function createMapArray<T>(array: Array<T>, key?: string): Record<string, Array<T>>;

package/lib/createMapArray.js

@@ -1,32 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-/**
- * Creates a grouped map from an array of items, using a specified property as the key.
- *
- * This utility transforms an array of objects into a lookup object/dictionary where
- * each value is an array of items sharing the same key value. Unlike createMap,
- * this function preserves all items with the same key by grouping them in arrays.
- *
- * @template T The type of items in the input array
- * @param array - The input array of items to transform into a grouped map
- * @param key - The property name to use as keys in the resulting map (defaults to '_id')
- * @returns A record object where keys are values of the specified property and values are arrays of items
- *
- * @example
- * // Returns { 'category1': [{ id: 1, category: 'category1' }, { id: 3, category: 'category1' }],
- * //           'category2': [{ id: 2, category: 'category2' }] }
- * createMapArray([
- *   { id: 1, category: 'category1' },
- *   { id: 2, category: 'category2' },
- *   { id: 3, category: 'category1' }
- * ], 'category')
- */
-function createMapArray(array, key = '_id') {
-    const map = {};
-    for (const item of array) {
-        map[item[key]] = map[item[key]] || [];
-        map[item[key]].push(item);
-    }
-    return map;
-}
-exports.default = createMapArray;

package/lib/createMapArray.test.d.ts

@@ -1 +0,0 @@
-export {};

package/lib/createMapArray.test.js

@@ -1,101 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-const createMapArray_1 = __importDefault(require("./createMapArray"));
-describe('createMapArray', () => {
-    it('should create a map of arrays using the default _id key', () => {
-        const array = [
-            { _id: '1', name: 'Item 1' },
-            { _id: '2', name: 'Item 2' },
-            { _id: '1', name: 'Item 1 Duplicate' }
-        ];
-        const result = (0, createMapArray_1.default)(array);
-        expect(result).toEqual({
-            '1': [
-                { _id: '1', name: 'Item 1' },
-                { _id: '1', name: 'Item 1 Duplicate' }
-            ],
-            '2': [
-                { _id: '2', name: 'Item 2' }
-            ]
-        });
-    });
-    it('should create a map of arrays using a custom key', () => {
-        const array = [
-            { category: 'A', name: 'Item A1' },
-            { category: 'B', name: 'Item B1' },
-            { category: 'A', name: 'Item A2' },
-            { category: 'C', name: 'Item C1' },
-            { category: 'B', name: 'Item B2' }
-        ];
-        const result = (0, createMapArray_1.default)(array, 'category');
-        expect(result).toEqual({
-            'A': [
-                { category: 'A', name: 'Item A1' },
-                { category: 'A', name: 'Item A2' }
-            ],
-            'B': [
-                { category: 'B', name: 'Item B1' },
-                { category: 'B', name: 'Item B2' }
-            ],
-            'C': [
-                { category: 'C', name: 'Item C1' }
-            ]
-        });
-    });
-    it('should handle empty arrays', () => {
-        const result = (0, createMapArray_1.default)([]);
-        expect(result).toEqual({});
-    });
-    it('should preserve the original order of items within each group', () => {
-        const array = [
-            { type: 'fruit', name: 'apple', order: 1 },
-            { type: 'vegetable', name: 'carrot', order: 1 },
-            { type: 'fruit', name: 'banana', order: 2 },
-            { type: 'fruit', name: 'cherry', order: 3 },
-            { type: 'vegetable', name: 'broccoli', order: 2 }
-        ];
-        const result = (0, createMapArray_1.default)(array, 'type');
-        // Items should be grouped by type and maintain their original order
-        expect(result.fruit.map(item => item.order)).toEqual([1, 2, 3]);
-        expect(result.vegetable.map(item => item.order)).toEqual([1, 2]);
-    });
-    it('should handle various key types', () => {
-        const array = [
-            { key: 1, value: 'Number key 1' },
-            { key: 1, value: 'Number key 2' },
-            { key: 'string', value: 'String key 1' },
-            { key: 'string', value: 'String key 2' },
-            { key: true, value: 'Boolean key' }
-        ];
-        const result = (0, createMapArray_1.default)(array, 'key');
-        expect(result).toEqual({
-            '1': [
-                { key: 1, value: 'Number key 1' },
-                { key: 1, value: 'Number key 2' }
-            ],
-            'string': [
-                { key: 'string', value: 'String key 1' },
-                { key: 'string', value: 'String key 2' }
-            ],
-            'true': [
-                { key: true, value: 'Boolean key' }
-            ]
-        });
-    });
-    it('should handle items with missing keys by using undefined', () => {
-        const array = [
-            { id: '1', name: 'Has ID' },
-            { name: 'No ID' },
-            { id: '2', name: 'Has ID 2' }
-        ];
-        const result = (0, createMapArray_1.default)(array, 'id');
-        expect(result).toEqual({
-            '1': [{ id: '1', name: 'Has ID' }],
-            '2': [{ id: '2', name: 'Has ID 2' }],
-            'undefined': [{ name: 'No ID' }]
-        });
-    });
-});

package/lib/generateId.d.ts

@@ -1,6 +0,0 @@
-/**
- * Returns a random ID
- * @param charsCount length of the ID
- * @param chars characters used to generate the ID
- */
-export default function generateId(charsCount?: number, chars?: string): string;

package/lib/generateId.js

@@ -1,54 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-const crypto_1 = __importDefault(require("crypto"));
-const UNMISTAKABLE_CHARS = '23456789ABCDEFGHJKLMNPQRSTWXYZabcdefghjkmnopqrstuvwxyz';
-const hexString = function (digits) {
-    var numBytes = Math.ceil(digits / 2);
-    var bytes;
-    // Try to get cryptographically strong randomness. Fall back to
-    // non-cryptographically strong if not available.
-    try {
-        bytes = crypto_1.default.randomBytes(numBytes);
-    }
-    catch (e) {
-        // XXX should re-throw any error except insufficient entropy
-        bytes = crypto_1.default.pseudoRandomBytes(numBytes);
-    }
-    var result = bytes.toString('hex');
-    // If the number of digits is odd, we'll have generated an extra 4 bits
-    // of randomness, so we need to trim the last digit.
-    return result.substring(0, digits);
-};
-const fraction = function () {
-    var numerator = parseInt(hexString(8), 16);
-    return numerator * 2.3283064365386963e-10; // 2^-32
-};
-const choice = function (arrayOrString) {
-    var index = Math.floor(fraction() * arrayOrString.length);
-    if (typeof arrayOrString === 'string')
-        return arrayOrString.substr(index, 1);
-    else
-        return arrayOrString[index];
-};
-const randomString = function (charsCount, alphabet) {
-    var digits = [];
-    for (var i = 0; i < charsCount; i++) {
-        digits[i] = choice(alphabet);
-    }
-    return digits.join('');
-};
-/**
- * Returns a random ID
- * @param charsCount length of the ID
- * @param chars characters used to generate the ID
- */
-function generateId(charsCount, chars = UNMISTAKABLE_CHARS) {
-    if (!charsCount) {
-        charsCount = 17;
-    }
-    return randomString(charsCount, chars);
-}
-exports.default = generateId;

package/lib/generateId.test.d.ts

@@ -1 +0,0 @@
-export {};

package/lib/generateId.test.js

@@ -1,11 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-const generateId_1 = __importDefault(require("./generateId"));
-const isString_1 = __importDefault(require("lodash/isString"));
-it('should generate random ids', async () => {
-    expect((0, generateId_1.default)()).not.toBe((0, generateId_1.default)());
-    expect((0, isString_1.default)((0, generateId_1.default)())).toBe(true);
-});

package/lib/generateUUID.d.ts

@@ -1,2 +0,0 @@
-export declare function generateUUID(): any;
-export declare function generateUUIDWithPrefix(prefix: string): string;

package/lib/generateUUID.js

@@ -1,12 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.generateUUIDWithPrefix = exports.generateUUID = void 0;
-const uuid_1 = require("uuid");
-function generateUUID() {
-    return (0, uuid_1.v4)();
-}
-exports.generateUUID = generateUUID;
-function generateUUIDWithPrefix(prefix) {
-    return `${prefix}-${generateUUID()}`;
-}
-exports.generateUUIDWithPrefix = generateUUIDWithPrefix;

package/lib/generateUUID.test.d.ts

@@ -1 +0,0 @@
-export {};

package/lib/generateUUID.test.js

@@ -1,15 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-const isString_1 = __importDefault(require("lodash/isString"));
-const generateUUID_1 = require("./generateUUID");
-it('should generate random uuid v4', async () => {
-    expect((0, generateUUID_1.generateUUID)()).not.toBe((0, generateUUID_1.generateUUID)());
-    expect((0, isString_1.default)((0, generateUUID_1.generateUUID)())).toBe(true);
-});
-it('should generate uuid with prefix', async () => {
-    expect((0, generateUUID_1.generateUUIDWithPrefix)('test')).not.toBe((0, generateUUID_1.generateUUIDWithPrefix)('test'));
-    expect((0, isString_1.default)((0, generateUUID_1.generateUUIDWithPrefix)('test'))).toBe(true);
-});

package/lib/hashObject.d.ts

@@ -1 +0,0 @@
-export default function (object: any): string;

package/lib/hashObject.js

@@ -1,10 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-const object_hash_1 = __importDefault(require("object-hash"));
-function default_1(object) {
-    return (0, object_hash_1.default)(object);
-}
-exports.default = default_1;

package/lib/hashObject.test.d.ts

@@ -1 +0,0 @@
-export {};

package/lib/hashObject.test.js

@@ -1,30 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-const hashObject_1 = __importDefault(require("./hashObject"));
-it('should create a string hash of an object', async () => {
-    const object = {
-        hello: 'world',
-        date: new Date(),
-        subObject: {
-            name: 'Nicolás'
-        }
-    };
-    const hash = (0, hashObject_1.default)(object);
-    expect(typeof hash).toBe('string');
-});
-it('object with different key orders should return same hash', async () => {
-    const object1 = {
-        one: '1',
-        two: '2'
-    };
-    const object2 = {
-        two: '2',
-        one: '1'
-    };
-    const hash1 = (0, hashObject_1.default)(object1);
-    const hash2 = (0, hashObject_1.default)(object2);
-    expect(hash1).toBe(hash2);
-});

package/lib/index.d.ts

@@ -1,13 +0,0 @@
-import sleep from './sleep';
-import hashObject from './hashObject';
-import generateId from './generateId';
-import createMap from './createMap';
-import createMapArray from './createMapArray';
-import { OrionError, OrionErrorInformation, PermissionsError, UserError, isOrionError, isUserError, isPermissionsError } from './Errors';
-export * from './composeMiddlewares';
-export * from './retries';
-export * from './generateUUID';
-export * from './normalize';
-export * from './searchTokens';
-export * from './shortenMongoId';
-export { createMap, createMapArray, generateId, hashObject, sleep, OrionError, PermissionsError, UserError, OrionErrorInformation, isOrionError, isUserError, isPermissionsError };

package/lib/index.js

@@ -1,40 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.isPermissionsError = exports.isUserError = exports.isOrionError = exports.UserError = exports.PermissionsError = exports.OrionError = exports.sleep = exports.hashObject = exports.generateId = exports.createMapArray = exports.createMap = void 0;
-const sleep_1 = __importDefault(require("./sleep"));
-exports.sleep = sleep_1.default;
-const hashObject_1 = __importDefault(require("./hashObject"));
-exports.hashObject = hashObject_1.default;
-const generateId_1 = __importDefault(require("./generateId"));
-exports.generateId = generateId_1.default;
-const createMap_1 = __importDefault(require("./createMap"));
-exports.createMap = createMap_1.default;
-const createMapArray_1 = __importDefault(require("./createMapArray"));
-exports.createMapArray = createMapArray_1.default;
-// Import all error-related exports from the Errors module
-const Errors_1 = require("./Errors");
-Object.defineProperty(exports, "OrionError", { enumerable: true, get: function () { return Errors_1.OrionError; } });
-Object.defineProperty(exports, "PermissionsError", { enumerable: true, get: function () { return Errors_1.PermissionsError; } });
-Object.defineProperty(exports, "UserError", { enumerable: true, get: function () { return Errors_1.UserError; } });
-Object.defineProperty(exports, "isOrionError", { enumerable: true, get: function () { return Errors_1.isOrionError; } });
-Object.defineProperty(exports, "isUserError", { enumerable: true, get: function () { return Errors_1.isUserError; } });
-Object.defineProperty(exports, "isPermissionsError", { enumerable: true, get: function () { return Errors_1.isPermissionsError; } });
-__exportStar(require("./composeMiddlewares"), exports);
-__exportStar(require("./retries"), exports);
-__exportStar(require("./generateUUID"), exports);
-__exportStar(require("./normalize"), exports);
-__exportStar(require("./searchTokens"), exports);
-__exportStar(require("./shortenMongoId"), exports);

package/lib/normalize.d.ts

@@ -1,70 +0,0 @@
-/**
- * Removes diacritical marks (accents) from text without any other modifications.
- * This is the most basic normalization function that others build upon.
- *
- * @param text - The input string to process
- * @returns String with accents removed but otherwise unchanged
- */
-export declare function removeAccentsOnly(text: string): string;
-/**
- * Normalizes text by removing diacritical marks (accents) and trimming whitespace.
- * Builds on removeAccentsOnly and adds whitespace trimming.
- *
- * @param text - The input string to normalize
- * @returns Normalized string with accents removed and whitespace trimmed
- */
-export declare function removeAccentsAndTrim(text: string): string;
-/**
- * Normalizes text for search purposes by:
- * - Removing diacritical marks (accents)
- * - Converting to lowercase
- * - Trimming whitespace
- *
- * Builds on removeAccentsAndTrim and adds lowercase conversion.
- * Useful for case-insensitive and accent-insensitive text searching.
- *
- * @param text - The input string to normalize for search
- * @returns Search-optimized string in lowercase with accents removed
- */
-export declare function normalizeForSearch(text: string): string;
-/**
- * Normalizes text for search purposes by:
- * - Removing diacritical marks (accents)
- * - Converting to lowercase
- * - Trimming whitespace
- * - Removing all spaces
- *
- * Builds on normalizeForSearch and removes all whitespace.
- * Useful for compact search indexes or when spaces should be ignored in searches.
- *
- * @param text - The input string to normalize for compact search
- * @returns Compact search-optimized string with no spaces
- */
-export declare function normalizeForCompactSearch(text: string): string;
-/**
- * Normalizes text for search token processing by:
- * - Removing diacritical marks (accents)
- * - Converting to lowercase
- * - Trimming whitespace
- * - Replacing all non-alphanumeric characters with spaces
- *
- * Builds on normalizeForSearch and replaces non-alphanumeric characters with spaces.
- * Useful for tokenizing search terms where special characters should be treated as word separators.
- *
- * @param text - The input string to normalize for tokenized search
- * @returns Search token string with only alphanumeric characters and spaces
- */
-export declare function normalizeForSearchToken(text: string): string;
-/**
- * Normalizes a string specifically for use as a file key (e.g., in S3 or other storage systems).
- * Performs the following transformations:
- * - Removes accents/diacritical marks
- * - Replaces special characters with hyphens
- * - Ensures only alphanumeric characters, hyphens, periods, and underscores remain
- * - Replaces multiple consecutive hyphens with a single hyphen
- * - Removes leading/trailing hyphens
- *
- * @param text - The input string to normalize for file key usage
- * @returns A storage-safe string suitable for use as a file key
- */
-export declare function normalizeForFileKey(text: string): string;