@poppinss/utils 6.5.0-3 → 6.5.0-5

package/build/src/fs_import_all.js

@@ -1,28 +0,0 @@
-import { fileURLToPath } from 'node:url';
-import lodash from '@poppinss/utils/lodash';
-import { extname, relative, sep } from 'node:path';
-import { fsReadAll } from './fs_read_all.js';
-import { isScriptFile } from './is_script_file.js';
-async function importFile(basePath, fileURL, values, options) {
-    const filePath = fileURLToPath(fileURL);
-    const fileExtension = extname(filePath);
-    const collectionKey = relative(basePath, filePath)
-        .replace(new RegExp(`${fileExtension}$`), '')
-        .split(sep);
-    const exportedValue = fileExtension === '.json'
-        ? await import(fileURL, { assert: { type: 'json' } })
-        : await import(fileURL);
-    lodash.set(values, options.transformKeys ? options.transformKeys(collectionKey) : collectionKey, exportedValue.default ? exportedValue.default : { ...exportedValue });
-}
-export async function fsImportAll(location, options) {
-    options = options || {};
-    const collection = {};
-    const normalizedLocation = typeof location === 'string' ? location : fileURLToPath(location);
-    const files = await fsReadAll(normalizedLocation, {
-        filter: isScriptFile,
-        ...options,
-        pathType: 'url',
-    });
-    await Promise.all(files.map((file) => importFile(normalizedLocation, file, collection, options)));
-    return collection;
-}

package/build/src/fs_read_all.d.ts

@@ -1,3 +0,0 @@
-/// <reference types="@types/node" resolution-mode="require"/>
-import { ReadAllFilesOptions } from './types.js';
-export declare function fsReadAll(location: string | URL, options?: ReadAllFilesOptions): Promise<string[]>;

package/build/src/fs_read_all.js

@@ -1,55 +0,0 @@
-import { join } from 'node:path';
-import { readdir, stat } from 'node:fs/promises';
-import { fileURLToPath, pathToFileURL } from 'node:url';
-import { slash } from './slash.js';
-import { naturalSort } from './natural_sort.js';
-function filterDotFiles(fileName) {
-    return fileName[0] !== '.';
-}
-async function readFiles(root, files, options, relativePath) {
-    const location = join(root, relativePath);
-    const stats = await stat(location);
-    if (stats.isDirectory()) {
-        let locationFiles = await readdir(location);
-        await Promise.all(locationFiles.filter(filterDotFiles).map((file) => {
-            return readFiles(root, files, options, join(relativePath, file));
-        }));
-        return;
-    }
-    const pathType = options.pathType || 'relative';
-    switch (pathType) {
-        case 'relative':
-            files.push(relativePath);
-            break;
-        case 'absolute':
-            files.push(location);
-            break;
-        case 'unixRelative':
-            files.push(slash(relativePath));
-            break;
-        case 'unixAbsolute':
-            files.push(slash(location));
-            break;
-        case 'url':
-            files.push(pathToFileURL(location).href);
-    }
-}
-export async function fsReadAll(location, options) {
-    const normalizedLocation = typeof location === 'string' ? location : fileURLToPath(location);
-    const normalizedOptions = Object.assign({ absolute: false, sort: naturalSort }, options);
-    const files = [];
-    try {
-        await stat(normalizedLocation);
-    }
-    catch (error) {
-        if (normalizedOptions.ignoreMissingRoot) {
-            return [];
-        }
-        throw error;
-    }
-    await readFiles(normalizedLocation, files, normalizedOptions, '');
-    if (normalizedOptions.filter) {
-        return files.filter(normalizedOptions.filter).sort(normalizedOptions.sort);
-    }
-    return files.sort(normalizedOptions.sort);
-}

package/build/src/import_default.d.ts

@@ -1,3 +0,0 @@
-export declare function importDefault<T extends object>(importFn: () => Promise<T>, filePath?: string): Promise<T extends {
-    default: infer A;
-} ? A : never>;

package/build/src/import_default.js

@@ -1,15 +0,0 @@
-import { RuntimeException } from './exceptions/runtime_exception.js';
-export async function importDefault(importFn, filePath) {
-    const moduleExports = await importFn();
-    if (!('default' in moduleExports)) {
-        const errorMessage = filePath
-            ? `Missing "export default" in module "${filePath}"`
-            : `Missing "export default" from lazy import "${importFn}"`;
-        throw new RuntimeException(errorMessage, {
-            cause: {
-                source: importFn,
-            },
-        });
-    }
-    return moduleExports.default;
-}

package/build/src/is_script_file.d.ts

@@ -1 +0,0 @@
-export declare function isScriptFile(filePath: string): boolean;

package/build/src/is_script_file.js

@@ -1,12 +0,0 @@
-import { extname } from 'node:path';
-const JS_MODULES = ['.js', '.json', '.cjs', '.mjs'];
-export function isScriptFile(filePath) {
-    const ext = extname(filePath);
-    if (JS_MODULES.includes(ext)) {
-        return true;
-    }
-    if (ext === '.ts' && !filePath.endsWith('.d.ts')) {
-        return true;
-    }
-    return false;
-}

package/build/src/json/safe_parse.d.ts

@@ -1,2 +0,0 @@
-import { JSONReviver } from '../types.js';
-export declare function safeParse(jsonString: string, reviver?: JSONReviver): any;

package/build/src/json/safe_parse.js

@@ -1,7 +0,0 @@
-import { parse } from 'secure-json-parse';
-export function safeParse(jsonString, reviver) {
-    return parse(jsonString, reviver, {
-        protoAction: 'remove',
-        constructorAction: 'remove',
-    });
-}

package/build/src/json/safe_stringify.d.ts

@@ -1,2 +0,0 @@
-import { JSONReplacer } from '../types.js';
-export declare function safeStringify(value: any, replacer?: JSONReplacer, space?: string | number): string | undefined;

package/build/src/json/safe_stringify.js

@@ -1,18 +0,0 @@
-import { configure } from 'safe-stable-stringify';
-const stringify = configure({
-    bigint: false,
-    circularValue: undefined,
-    deterministic: false,
-});
-function jsonStringifyReplacer(replacer) {
-    return function (key, value) {
-        const val = replacer ? replacer.call(this, key, value) : value;
-        if (typeof val === 'bigint') {
-            return val.toString();
-        }
-        return val;
-    };
-}
-export function safeStringify(value, replacer, space) {
-    return stringify(value, jsonStringifyReplacer(replacer), space);
-}

package/build/src/message_builder.d.ts

@@ -1,5 +0,0 @@
-export declare class MessageBuilder {
-    #private;
-    build(message: any, expiresIn?: string | number, purpose?: string): string;
-    verify<T extends any>(message: any, purpose?: string): null | T;
-}

package/build/src/message_builder.js

@@ -1,38 +0,0 @@
-import json from './json/main.js';
-import milliseconds from './string/milliseconds.js';
-export class MessageBuilder {
-    #getExpiryDate(expiresIn) {
-        if (!expiresIn) {
-            return undefined;
-        }
-        const expiryMs = milliseconds.parse(expiresIn);
-        return new Date(Date.now() + expiryMs);
-    }
-    #isExpired(message) {
-        if (!message.expiryDate) {
-            return false;
-        }
-        const expiryDate = new Date(message.expiryDate);
-        return Number.isNaN(expiryDate.getTime()) || expiryDate < new Date();
-    }
-    build(message, expiresIn, purpose) {
-        const expiryDate = this.#getExpiryDate(expiresIn);
-        return json.safeStringify({ message, purpose, expiryDate });
-    }
-    verify(message, purpose) {
-        const parsed = json.safeParse(message);
-        if (typeof parsed !== 'object' || !parsed) {
-            return null;
-        }
-        if (!parsed.message) {
-            return null;
-        }
-        if (parsed.purpose !== purpose) {
-            return null;
-        }
-        if (this.#isExpired(parsed)) {
-            return null;
-        }
-        return parsed.message;
-    }
-}

package/build/src/natural_sort.d.ts

@@ -1 +0,0 @@
-export declare function naturalSort(current: string, next: string): number;

package/build/src/natural_sort.js

@@ -1,3 +0,0 @@
-export function naturalSort(current, next) {
-    return current.localeCompare(next, undefined, { numeric: true, sensitivity: 'base' });
-}

package/build/src/object_builder.d.ts

@@ -1,18 +0,0 @@
-import { OmitProperties } from './types.js';
-export declare class ObjectBuilder<ReturnType extends Record<string, any>, IgnoreNull extends boolean = false> {
-    #private;
-    values: ReturnType;
-    constructor(initialValue: ReturnType, ignoreNull?: IgnoreNull);
-    add<Prop extends string>(key: Prop, value: undefined): this;
-    add<Prop extends string, Value>(key: Prop, value: Value): ObjectBuilder<ReturnType & {
-        [P in Prop]: Value;
-    }, IgnoreNull>;
-    remove<K extends keyof ReturnType>(key: K): this;
-    has<K extends keyof ReturnType>(key: K): boolean;
-    get<K extends keyof ReturnType>(key: K): ReturnType[K];
-    toObject(): IgnoreNull extends true ? {
-        [K in keyof OmitProperties<ReturnType, null>]: ReturnType[K];
-    } : {
-        [K in keyof ReturnType]: ReturnType[K];
-    };
-}

package/build/src/object_builder.js

@@ -1,32 +0,0 @@
-export class ObjectBuilder {
-    #ignoreNull;
-    values;
-    constructor(initialValue, ignoreNull) {
-        this.values = initialValue;
-        this.#ignoreNull = ignoreNull === true ? true : false;
-    }
-    add(key, value) {
-        if (value === undefined) {
-            return this;
-        }
-        if (this.#ignoreNull === true && value === null) {
-            return this;
-        }
-        ;
-        this.values[key] = value;
-        return this;
-    }
-    remove(key) {
-        delete this.values[key];
-        return this;
-    }
-    has(key) {
-        return this.get(key) !== undefined;
-    }
-    get(key) {
-        return this.values[key];
-    }
-    toObject() {
-        return this.values;
-    }
-}

package/build/src/safe_equal.d.ts

@@ -1,7 +0,0 @@
-type BufferSafeValue = ArrayBuffer | SharedArrayBuffer | number[] | string | {
-    valueOf(): string | object;
-} | {
-    [Symbol.toPrimitive](hint: 'string'): string;
-};
-export declare function safeEqual<T extends BufferSafeValue, U extends BufferSafeValue>(trustedValue: T, userInput: U): boolean;
-export {};

package/build/src/safe_equal.js

@@ -1,14 +0,0 @@
-import { Buffer } from 'node:buffer';
-import { timingSafeEqual } from 'node:crypto';
-export function safeEqual(trustedValue, userInput) {
-    if (typeof trustedValue === 'string' && typeof userInput === 'string') {
-        const trustedLength = Buffer.byteLength(trustedValue);
-        const trustedValueBuffer = Buffer.alloc(trustedLength, 0, 'utf-8');
-        trustedValueBuffer.write(trustedValue);
-        const userValueBuffer = Buffer.alloc(trustedLength, 0, 'utf-8');
-        userValueBuffer.write(userInput);
-        return (timingSafeEqual(trustedValueBuffer, userValueBuffer) &&
-            trustedLength === Buffer.byteLength(userInput));
-    }
-    return timingSafeEqual(Buffer.from(trustedValue), Buffer.from(userInput));
-}

package/build/src/slash.d.ts

@@ -1 +0,0 @@
-export { default as slash } from 'slash';

package/build/src/slash.js

@@ -1 +0,0 @@
-export { default as slash } from 'slash';

package/build/src/string/bytes.d.ts

@@ -1,6 +0,0 @@
-import { BytesOptions } from 'bytes';
-declare const _default: {
-    format(valueInBytes: number, options?: BytesOptions): string;
-    parse(unit: string | number): number;
-};
-export default _default;

package/build/src/string/bytes.js

@@ -1,12 +0,0 @@
-import bytes from 'bytes';
-export default {
-    format(valueInBytes, options) {
-        return bytes.format(valueInBytes, options);
-    },
-    parse(unit) {
-        if (typeof unit === 'number') {
-            return unit;
-        }
-        return bytes.parse(unit);
-    },
-};

package/build/src/string/change_case.d.ts

@@ -1,13 +0,0 @@
-export declare function titleCase(input: string): string;
-export declare function camelCase(value: string): string;
-export declare function snakeCase(value: string): string;
-export declare function dashCase(value: string, options?: {
-    capitalize?: boolean;
-}): string;
-export declare function pascalCase(value: string): string;
-export declare function capitalCase(value: string): string;
-export declare function sentenceCase(value: string): string;
-export declare function dotCase(value: string, options?: {
-    lowerCase?: boolean;
-}): string;
-export declare function noCase(value: string, transform?: (part: string, index: number, parts: string[]) => string): string;

package/build/src/string/change_case.js

@@ -1,75 +0,0 @@
-import * as changeCase from 'case-anything';
-const NO_CASE_SPLIT_REGEXP = [/([a-z0-9])([A-Z])/g, /([A-Z])([A-Z][a-z])/g];
-const NO_CASE_STRIP_REGEXP = /[^A-Z0-9]+/gi;
-const SMALL_WORDS = /\b(?:an?d?|a[st]|because|but|by|en|for|i[fn]|neither|nor|o[fnr]|only|over|per|so|some|tha[tn]|the|to|up|upon|vs?\.?|versus|via|when|with|without|yet)\b/i;
-const TOKENS = /[^\s:–—-]+|./g;
-const WHITESPACE = /\s/;
-const IS_MANUAL_CASE = /.(?=[A-Z]|\..)/;
-const ALPHANUMERIC_PATTERN = /[A-Za-z0-9\u00C0-\u00FF]/;
-export function titleCase(input) {
-    let output = '';
-    let result;
-    while ((result = TOKENS.exec(input)) !== null) {
-        const { 0: token, index } = result;
-        if (!IS_MANUAL_CASE.test(token) &&
-            (!SMALL_WORDS.test(token) || index === 0 || index + token.length === input.length) &&
-            (input.charAt(index + token.length) !== ':' ||
-                WHITESPACE.test(input.charAt(index + token.length + 1)))) {
-            output += token.replace(ALPHANUMERIC_PATTERN, (char) => char.toUpperCase());
-            continue;
-        }
-        output += token;
-    }
-    return output;
-}
-export function camelCase(value) {
-    return changeCase.camelCase(value);
-}
-export function snakeCase(value) {
-    return changeCase.snakeCase(value);
-}
-export function dashCase(value, options) {
-    if (options && options.capitalize) {
-        return changeCase.trainCase(value);
-    }
-    return changeCase.kebabCase(value);
-}
-export function pascalCase(value) {
-    return changeCase.pascalCase(value);
-}
-export function capitalCase(value) {
-    return changeCase.capitalCase(value);
-}
-export function sentenceCase(value) {
-    return noCase(value, (input, index) => {
-        const result = input.toLowerCase();
-        if (index === 0) {
-            return input.charAt(0).toUpperCase() + input.substring(1);
-        }
-        return result;
-    });
-}
-export function dotCase(value, options) {
-    const transformedValue = changeCase.dotNotation(value);
-    if (options && options.lowerCase) {
-        return transformedValue.toLowerCase();
-    }
-    return transformedValue;
-}
-export function noCase(value, transform) {
-    let result = NO_CASE_SPLIT_REGEXP.reduce((input, regex) => input.replace(regex, '$1\0$2'), value);
-    result = result.replace(NO_CASE_STRIP_REGEXP, '\0');
-    let start = 0;
-    let end = result.length;
-    while (result.charAt(start) === '\0') {
-        start++;
-    }
-    while (result.charAt(end - 1) === '\0') {
-        end--;
-    }
-    return result
-        .slice(start, end)
-        .split('\0')
-        .map(transform || ((input) => input.toLowerCase()))
-        .join(' ');
-}

package/build/src/string/excerpt.d.ts

@@ -1,4 +0,0 @@
-export declare function excerpt(sentence: string, charactersLimit: number, options?: {
-    completeWords?: boolean;
-    suffix?: string;
-}): string;

package/build/src/string/excerpt.js

@@ -1,10 +0,0 @@
-import truncatise from 'truncatise';
-export function excerpt(sentence, charactersLimit, options) {
-    return truncatise(sentence, {
-        TruncateLength: charactersLimit,
-        Strict: options && options.completeWords === true ? false : true,
-        StripHTML: true,
-        TruncateBy: 'characters',
-        Suffix: options && options.suffix,
-    });
-}

package/build/src/string/interpolate.d.ts

@@ -1 +0,0 @@
-export declare function interpolate(input: string, data: any): string;

package/build/src/string/interpolate.js

@@ -1,19 +0,0 @@
-function parseProp(data, key) {
-    const tokens = key.split('.');
-    while (tokens.length) {
-        if (data === null || typeof data !== 'object') {
-            return;
-        }
-        const token = tokens.shift();
-        data = Object.hasOwn(data, token) ? data[token] : undefined;
-    }
-    return data;
-}
-export function interpolate(input, data) {
-    return input.replace(/(\\)?{{(.*?)}}/g, (_, escapeChar, key) => {
-        if (escapeChar) {
-            return `{{${key}}}`;
-        }
-        return parseProp(data, key.trim());
-    });
-}

package/build/src/string/milliseconds.d.ts

@@ -1,5 +0,0 @@
-declare const _default: {
-    format(milliseconds: number, long?: boolean): string;
-    parse(duration: string | number): number;
-};
-export default _default;

package/build/src/string/milliseconds.js

@@ -1,16 +0,0 @@
-import { parse, format } from '@lukeed/ms';
-export default {
-    format(milliseconds, long) {
-        return format(milliseconds, long);
-    },
-    parse(duration) {
-        if (typeof duration === 'number') {
-            return duration;
-        }
-        const milliseconds = parse(duration);
-        if (milliseconds === undefined) {
-            throw new Error(`Invalid duration expression "${duration}"`);
-        }
-        return milliseconds;
-    },
-};

package/build/src/string/ordinal.d.ts

@@ -1 +0,0 @@
-export declare function ordinal(value: string | number): string;

package/build/src/string/ordinal.js

@@ -1,21 +0,0 @@
-export function ordinal(value) {
-    const transformedValue = Math.abs(typeof value === 'string' ? Number.parseInt(value) : value);
-    if (!Number.isFinite(transformedValue) || Number.isNaN(transformedValue)) {
-        throw new Error('Cannot ordinalize invalid or infinite numbers');
-    }
-    const percent = transformedValue % 100;
-    if (percent >= 10 && percent <= 20) {
-        return `${value}th`;
-    }
-    const decimal = transformedValue % 10;
-    switch (decimal) {
-        case 1:
-            return `${value}st`;
-        case 2:
-            return `${value}nd`;
-        case 3:
-            return `${value}rd`;
-        default:
-            return `${value}th`;
-    }
-}

package/build/src/string/pluralize.d.ts

@@ -1,12 +0,0 @@
-import { default as pluralizePkg } from 'pluralize';
-export declare function pluralize(word: string, count?: number, inclusive?: boolean): string;
-export declare namespace pluralize {
-    var addPluralRule: typeof pluralizePkg.addPluralRule;
-    var addSingularRule: typeof pluralizePkg.addSingularRule;
-    var addIrregularRule: typeof pluralizePkg.addIrregularRule;
-    var addUncountableRule: typeof pluralizePkg.addUncountableRule;
-}
-export declare const plural: typeof pluralizePkg.plural;
-export declare const singular: typeof pluralizePkg.singular;
-export declare const isPlural: typeof pluralizePkg.isPlural;
-export declare const isSingular: typeof pluralizePkg.isSingular;

package/build/src/string/pluralize.js

@@ -1,12 +0,0 @@
-import { default as pluralizePkg } from 'pluralize';
-export function pluralize(word, count, inclusive) {
-    return pluralizePkg(word, count, inclusive);
-}
-pluralize.addPluralRule = pluralizePkg.addPluralRule;
-pluralize.addSingularRule = pluralizePkg.addSingularRule;
-pluralize.addIrregularRule = pluralizePkg.addIrregularRule;
-pluralize.addUncountableRule = pluralizePkg.addUncountableRule;
-export const plural = pluralizePkg.plural;
-export const singular = pluralizePkg.singular;
-export const isPlural = pluralizePkg.isPlural;
-export const isSingular = pluralizePkg.isSingular;

package/build/src/string/random.d.ts

@@ -1 +0,0 @@
-export declare function random(size: number): string;

package/build/src/string/random.js

@@ -1,7 +0,0 @@
-import { randomBytes } from 'node:crypto';
-import { base64 } from '../base64.js';
-export function random(size) {
-    const bits = (size + 1) * 6;
-    const buffer = randomBytes(Math.ceil(bits / 8));
-    return base64.urlEncode(buffer).slice(0, size);
-}

package/build/src/string/seconds.d.ts

@@ -1,5 +0,0 @@
-declare const _default: {
-    format(seconds: number, long?: boolean): string;
-    parse(duration: string | number): number;
-};
-export default _default;

package/build/src/string/seconds.js

@@ -1,16 +0,0 @@
-import { parse, format } from '@lukeed/ms';
-export default {
-    format(seconds, long) {
-        return format(seconds * 1000, long);
-    },
-    parse(duration) {
-        if (typeof duration === 'number') {
-            return duration;
-        }
-        const milliseconds = parse(duration);
-        if (milliseconds === undefined) {
-            throw new Error(`Invalid duration expression "${duration}"`);
-        }
-        return Math.floor(milliseconds / 1000);
-    },
-};

package/build/src/string/sentence.d.ts

@@ -1,5 +0,0 @@
-export declare function sentence(values: any[], options?: {
-    separator?: string;
-    pairSeparator?: string;
-    lastSeparator?: string;
-}): string;

package/build/src/string/sentence.js

@@ -1,13 +0,0 @@
-export function sentence(values, options) {
-    if (values.length === 0) {
-        return '';
-    }
-    if (values.length === 1) {
-        return values[0];
-    }
-    if (values.length === 2) {
-        return `${values[0]}${options?.pairSeparator || ' and '}${values[1]}`;
-    }
-    const normalized = Object.assign({ separator: ', ', lastSeparator: ', and ' }, options);
-    return `${values.slice(0, -1).join(normalized.separator)}${normalized.lastSeparator}${values[values.length - 1]}`;
-}

package/build/src/string/slugify.d.ts

@@ -1,2 +0,0 @@
-import { default as slugifyPkg } from 'slugify';
-export declare const slug: typeof slugifyPkg.default;

package/build/src/string/slugify.js

@@ -1,2 +0,0 @@
-import { default as slugifyPkg } from 'slugify';
-export const slug = slugifyPkg;

package/build/src/string/truncate.d.ts

@@ -1,4 +0,0 @@
-export declare function truncate(sentence: string, charactersLimit: number, options?: {
-    completeWords?: boolean;
-    suffix?: string;
-}): string;

package/build/src/string/truncate.js

@@ -1,10 +0,0 @@
-import truncatise from 'truncatise';
-export function truncate(sentence, charactersLimit, options) {
-    return truncatise(sentence, {
-        TruncateLength: charactersLimit,
-        Strict: options && options.completeWords === true ? false : true,
-        StripHTML: false,
-        TruncateBy: 'characters',
-        Suffix: options && options.suffix,
-    });
-}