@naturalcycles/js-lib 14.276.0 → 15.0.0

package/dist-esm/string/stringify.js

@@ -1,133 +0,0 @@
-import { _isBackendErrorResponseObject, _isErrorLike, _isErrorObject } from '../error/error.util';
-import { _jsonParseIfPossible } from './json.util';
-import { _safeJsonStringify } from './safeJsonStringify';
-const supportsAggregateError = typeof globalThis.AggregateError === 'function';
-let globalStringifyFunction = _safeJsonStringify;
-/**
- * Allows to set Global "stringifyFunction" that will be used to "pretty-print" objects
- * in various cases.
- *
- * Used, for example, by _stringify() to pretty-print objects/arrays.
- *
- * Defaults to _safeJsonStringify.
- *
- * Node.js project can set it to _inspect, which allows to use `util.inspect`
- * as pretty-printing function.
- *
- * It's recommended that this function is circular-reference-safe.
- */
-export function setGlobalStringifyFunction(fn) {
-    globalStringifyFunction = fn;
-}
-/**
- * Inspired by `_inspect` from nodejs-lib, which is based on util.inpect that is not available in the Browser.
- * Potentially can do this (with extra 2Kb gz size): https://github.com/deecewan/browser-util-inspect
- *
- * Transforms ANY to human-readable string (via JSON.stringify pretty).
- * Safe (no error throwing).
- *
- * Correctly prints Errors, AppErrors, ErrorObjects: error.message + \n + _stringify(error.data)
- *
- * Enforces max length (default to 1000, pass 0 to skip it).
- *
- * Logs numbers as-is, e.g: `6`.
- * Logs strings as-is (without single quotes around, unlike default util.inspect behavior).
- * Otherwise - just uses JSON.stringify().
- *
- * Returns 'empty_string' if empty string is passed.
- * Returns 'undefined' if undefined is passed (default util.inspect behavior).
- */
-export function _stringify(obj, opt = {}) {
-    if (obj === undefined)
-        return 'undefined';
-    if (obj === null)
-        return 'null';
-    if (typeof obj === 'function')
-        return 'function';
-    if (typeof obj === 'symbol')
-        return obj.toString();
-    let s;
-    // Parse JSON string, if possible
-    obj = _jsonParseIfPossible(obj); // in case it's e.g non-pretty JSON, or even a stringified ErrorObject
-    //
-    // HttpErrorResponse
-    //
-    if (_isBackendErrorResponseObject(obj)) {
-        return _stringify(obj.error, opt);
-    }
-    if (obj instanceof Error || _isErrorLike(obj)) {
-        const { includeErrorCause = true } = opt;
-        //
-        // Error or ErrorLike
-        //
-        // Omit "default" error name as non-informative
-        // UPD: no, it's still important to understand that we're dealing with Error and not just some string
-        // if (obj?.name === 'Error') {
-        //   s = obj.message
-        // }
-        // if (_isErrorObject(obj) && _isHttpErrorObject(obj)) {
-        //   // Printing (0) to avoid ambiguity
-        //   s = `${obj.name}(${obj.data.backendResponseStatusCode}): ${obj.message}`
-        // }
-        s = [obj.name, obj.message].filter(Boolean).join(': ');
-        if (typeof obj.code === 'string') {
-            // Error that has no `data`, but has `code` property
-            s += `\ncode: ${obj.code}`;
-        }
-        if (opt.includeErrorData && _isErrorObject(obj) && Object.keys(obj.data).length) {
-            s += '\n' + _stringify(obj.data, opt);
-        }
-        if (opt.includeErrorStack && obj.stack) {
-            // Here we're using the previously-generated "title line" (e.g "Error: some_message"),
-            // concatenating it with the Stack (but without the title line of the Stack)
-            // This is to fix the rare error (happened with Got) where `err.message` was changed,
-            // but err.stack had "old" err.message
-            // This should "fix" that
-            const sLines = s.split('\n').length;
-            s = [s, ...obj.stack.split('\n').slice(sLines)].join('\n');
-        }
-        if (supportsAggregateError && obj instanceof AggregateError && obj.errors.length) {
-            s = [
-                s,
-                `${obj.errors.length} error(s):`,
-                ...obj.errors.map((err, i) => `${i + 1}. ${_stringify(err, opt)}`),
-            ].join('\n');
-        }
-        if (obj.cause && includeErrorCause) {
-            s = s + '\nCaused by: ' + _stringify(obj.cause, opt);
-        }
-    }
-    else if (typeof obj === 'string') {
-        //
-        // String
-        //
-        s = obj.trim() || 'empty_string';
-    }
-    else {
-        //
-        // Other
-        //
-        if (obj instanceof Map) {
-            obj = Object.fromEntries(obj);
-        }
-        else if (obj instanceof Set) {
-            obj = [...obj];
-        }
-        try {
-            const { stringifyFn = globalStringifyFunction } = opt;
-            s = stringifyFn(obj, undefined, 2);
-        }
-        catch {
-            s = String(obj); // fallback
-        }
-    }
-    // Shouldn't happen, but some weird input parameters may return this
-    if (s === undefined)
-        return 'undefined';
-    // Handle maxLen
-    const { maxLen = 10000 } = opt;
-    if (maxLen && s.length > maxLen) {
-        s = s.slice(0, maxLen) + `... ${Math.ceil(s.length / 1024)} KB message truncated`;
-    }
-    return s;
-}

package/dist-esm/string/url.util.js

@@ -1,42 +0,0 @@
-/**
- * Parses `location.search` string (e.g `?a=1&b=2`) into a StringMap, e.g:
- * `{ a: '1', b: '2' }`
- *
- * Pass `location.search` to it in the Frontend, or any other string on the Backend (where `location.search` is not available).
- *
- * Works both with and without leading `?` character.
- *
- * Yes, there's `URLSearchParams` existing in the Frontend (not in Node yet), but it's API is not
- * as convenient. And the implementation here is super-small.
- *
- * Goal of this function is to produce exactly same output as URLSearchParams would.
- */
-export function _parseQueryString(search) {
-    const qs = {};
-    search
-        .slice(search.startsWith('?') ? 1 : 0)
-        .split('&')
-        .forEach(p => {
-        const [k, v] = p.split('=');
-        if (!k)
-            return;
-        qs[decodeURIComponent(k)] = decodeURIComponent(v || '');
-    });
-    return qs;
-}
-/**
- * A wrapper around `new URL(href)`, but it returns `null` instead of throwing an error.
- * While `URL.parse` exists, and behaves similarly, it's not widely supported.
- *
- * `null` was chosen instead of `undefined` in the return type union to make it easier to move to `URL.parse` if it ever becomes widely supported.
- */
-export function _toUrlOrNull(url, base) {
-    if (typeof url !== 'string')
-        return null;
-    try {
-        return new URL(url, base || undefined);
-    }
-    catch {
-        return null;
-    }
-}

package/dist-esm/time/time.util.js

@@ -1,61 +0,0 @@
-/**
- * using _ = blockTimer()
- * // will log "took 1.234 sec" on dispose
- *
- * using _ = blockTimer('named')
- * // will log "named took 1.234 sec" on dispose
- *
- * @experimental
- */
-export function _blockTimer(name) {
-    const started = Date.now();
-    return {
-        [Symbol.dispose]() {
-            console.log(`${name ? name + ' ' : ''}took ${_since(started)}`);
-        },
-    };
-}
-/**
- * Returns time passed since `from` until `until` (default to Date.now())
- */
-export function _since(from, until = Date.now()) {
-    return _ms(until - from);
-}
-/**
- * Returns, e.g:
- * 125 ms
- * 1.125 sec
- * 11 sec
- * 1m12s
- * 59m2s
- * 1h3m12s
- */
-export function _ms(millis) {
-    // <1 sec
-    if (millis < 1000)
-        return `${Math.round(millis)} ms`;
-    // < 5 sec
-    if (millis < 5000) {
-        const s = millis / 1000;
-        return `${Math.trunc(s) === s ? s : s.toFixed(3)} sec`;
-    }
-    const sec = Math.floor(millis / 1000) % 60;
-    const min = Math.floor(millis / (60 * 1000)) % 60;
-    const hrs = Math.floor(millis / (3600 * 1000));
-    // <1 hr
-    if (hrs === 0) {
-        // <1 min
-        if (min === 0)
-            return `${sec} sec`;
-        return `${min}m${sec}s`;
-    }
-    if (hrs < 24) {
-        return `${hrs}h${min}m`;
-    }
-    if (hrs < 48) {
-        return `${Math.round(hrs + min / 60)}h`;
-    }
-    // >= 48 hours
-    const days = Math.floor(hrs / 24);
-    return `${days} days`;
-}

package/dist-esm/typeFest.js

@@ -1,2 +0,0 @@
-/* eslint-disable */
-export {};

package/dist-esm/types.js

@@ -1,59 +0,0 @@
-/**
- * Symbol to indicate END of Sequence.
- */
-export const END = Symbol('END');
-/**
- * Symbol to indicate SKIP of item (e.g in AbortableMapper)
- */
-export const SKIP = Symbol('SKIP');
-/**
- * Symbol to indicate cache miss.
- * To distinguish from cache returning `undefined` or `null`.
- */
-export const MISS = Symbol('MISS');
-export const _passthroughMapper = item => item;
-export const _passUndefinedMapper = () => undefined;
-/**
- * Function that does nothings and returns `undefined`.
- */
-export const _noop = (..._args) => undefined;
-export const _passthroughPredicate = () => true;
-export const _passNothingPredicate = () => false;
-/**
- * Needed due to https://github.com/microsoft/TypeScript/issues/13778
- * Only affects typings, no runtime effect.
- */
-export const _stringMapValues = Object.values;
-/**
- * Needed due to https://github.com/microsoft/TypeScript/issues/13778
- * Only affects typings, no runtime effect.
- */
-export const _stringMapEntries = Object.entries;
-/**
- * Alias of `Object.keys`, but returns keys typed as `keyof T`, not as just `string`.
- * This is how TypeScript should work, actually.
- */
-export const _objectKeys = Object.keys;
-/**
- * Alias of `Object.entries`, but returns better-typed output.
- *
- * So e.g you can use _objectEntries(obj).map([k, v] => {})
- * and `k` will be `keyof obj` instead of generic `string`.
- */
-export const _objectEntries = Object.entries;
-/**
- * Utility function that helps to cast *existing variable* to needed type T.
- *
- * @example
- * try {} catch (err) {
- *   // err is unknown here
- *   _typeCast<AppError>(err)
- *   // now err is of type AppError
- *   err.data = {} // can be done, because it was casted
- * }
- */
-export function _typeCast(v) { }
-/**
- * Type-safe Object.assign that checks that part is indeed a Partial<T>
- */
-export const _objectAssign = Object.assign;

package/dist-esm/unit/size.util.js

@@ -1,43 +0,0 @@
-export function _gb(b) {
-    return Math.round(b / 1024 ** 3);
-}
-export function _mb(b) {
-    return Math.round(b / 1024 ** 2);
-}
-export function _kb(b) {
-    return Math.round(b / 1024);
-}
-/**
- * Byte size to Human byte size string
- */
-export function _hb(b = 0) {
-    if (b < 1024)
-        return `${Math.round(b)} byte(s)`;
-    if (b < 1024 ** 2)
-        return `${(b / 1024).toPrecision(3)} Kb`;
-    if (b < 1024 ** 3)
-        return `${(b / 1024 ** 2).toPrecision(3)} Mb`;
-    if (b < 1024 ** 4)
-        return `${(b / 1024 ** 3).toPrecision(3)} Gb`;
-    if (b < 1024 ** 5)
-        return `${(b / 1024 ** 4).toPrecision(3)} Tb`;
-    return `${Math.round(b / 1024 ** 4)} Tb`;
-}
-/**
- * hc stands for "human count", similar to "human bytes" `_hb` function.
- * Helpful to print big numbers, as it adds `K` (kilo), `M` (mega), etc to make
- * them more readable.
- */
-export function _hc(c = 0) {
-    if (c < 10 ** 4)
-        return String(c);
-    if (c < 10 ** 6)
-        return (c / 10 ** 3).toPrecision(3) + ' K';
-    if (c < 10 ** 9)
-        return (c / 10 ** 6).toPrecision(3) + ' M'; // million
-    if (c < 10 ** 12)
-        return (c / 10 ** 9).toPrecision(3) + ' B'; // billion
-    if (c < 10 ** 15)
-        return (c / 10 ** 12).toPrecision(3) + ' T'; // trillion
-    return Math.round(c / 10 ** 12) + ' T';
-}

package/dist-esm/web.js

@@ -1,40 +0,0 @@
-/// <reference lib="es2022" preserve="true" />
-/// <reference lib="dom" preserve="true" />
-/**
- * Implements WebStorage API by using in-memory storage.
- * Can be useful in SSR environment or unit tests.
- *
- * This is how localStorage can be mocked in Node:
- *
- * Object.assign(globalThis, {
- *  localStorage: new InMemoryWebStorage(),
- * })
- *
- * @experimental
- */
-export class InMemoryWebStorage {
-    constructor(data = {}) {
-        this.data = data;
-    }
-    // Not implementing "free property access" now for simplicity,
-    // but can be implemented with Proxy
-    // [ name: string ]: any
-    getItem(key) {
-        return this.data[key] ?? null;
-    }
-    setItem(key, value) {
-        this.data[key] = String(value);
-    }
-    removeItem(key) {
-        delete this.data[key];
-    }
-    key(index) {
-        return Object.keys(this.data)[index] ?? null;
-    }
-    clear() {
-        this.data = {};
-    }
-    get length() {
-        return Object.keys(this.data).length;
-    }
-}

package/dist-esm/zod/index.js

@@ -1,4 +0,0 @@
-export * from './zod.shared.schemas';
-export * from './zod.util';
-import { z, ZodError, ZodSchema } from 'zod';
-export { z, ZodError, ZodSchema };

package/dist-esm/zod/zod.shared.schemas.js

@@ -1,92 +0,0 @@
-import { z } from 'zod';
-export const TS_2500 = 16725225600; // 2500-01-01
-export const TS_2000 = 946684800; // 2000-01-01
-export const zUnixTimestamp = z
-    .number()
-    .int()
-    .min(0)
-    .max(TS_2500, 'Must be a UnixTimestamp number')
-    .describe('UnixTimestamp');
-export const zUnixTimestamp2000 = z
-    .number()
-    .int()
-    .min(TS_2000)
-    .max(TS_2500, 'Must be a UnixTimestamp number after 2000-01-01')
-    .describe('UnixTimestamp2000');
-export const zUnixTimestampMillis = z
-    .number()
-    .int()
-    .min(0)
-    .max(TS_2500 * 1000, 'Must be a UnixTimestampMillis number')
-    .describe('UnixTimestampMillis');
-export const zUnixTimestampMillis2000 = z
-    .number()
-    .int()
-    .min(TS_2000 * 1000)
-    .max(TS_2500 * 1000, 'Must be a UnixTimestampMillis number after 2000-01-01')
-    .describe('UnixTimestampMillis2000');
-export const zSemVer = z
-    .string()
-    .regex(/^[0-9]+\.[0-9]+\.[0-9]+$/, 'Must be a SemVer string')
-    .describe('SemVer');
-export const zIsoDateString = z
-    .string()
-    .refine(v => {
-    return /^\d{4}-\d{2}-\d{2}$/.test(v);
-}, 'Must be an IsoDateString')
-    .describe('IsoDateString');
-export const zEmail = z
-    .string()
-    .trim()
-    .email()
-    .transform(s => s.toLowerCase())
-    .describe('Email');
-export const BASE62_REGEX = /^[a-zA-Z0-9]+$/;
-export const BASE64_REGEX = /^[A-Za-z0-9+/]+={0,2}$/;
-export const BASE64URL_REGEX = /^[\w-/]+$/;
-export const zBase62 = z
-    .string()
-    .regex(BASE62_REGEX, 'Must be a base62 string')
-    .describe('Base62String');
-export const zBase64 = z
-    .string()
-    .regex(BASE64_REGEX, 'Must be a base64 string')
-    .describe('Base64String');
-export const zBase64Url = z
-    .string()
-    .regex(BASE64URL_REGEX, 'Must be a base64url string')
-    .describe('Base64UrlString');
-export const JWT_REGEX = /^[\w-]+\.[\w-]+\.[\w-]+$/;
-export const zJwt = z.string().regex(JWT_REGEX, 'Must be a JWT string').describe('JWTString');
-export const zId = z
-    .string()
-    .regex(/^[a-zA-Z0-9_]{6,64}$/, 'Must be an id string')
-    .describe('IdString');
-export const zIdBase62 = z
-    .string()
-    .regex(/^[a-zA-Z0-9]{8,64}$/, 'Must be a base62 id string')
-    .describe('Base62Id');
-export const zIdBase64 = z
-    .string()
-    .regex(/^[A-Za-z0-9+/]{6,62}={0,2}$/, 'Must be a base64 id string')
-    .describe('Base64Id');
-export const zIdBase64Url = z
-    .string()
-    .regex(/^[\w-/]{8,64}$/, 'Must be a base64url id string')
-    .describe('Base64UrlId');
-/**
- * "Slug" - a valid URL, filename, etc.
- */
-export const zSlug = z
-    .string()
-    .regex(/^[a-z0-9-]{1,255}$/, 'Must be a slug string')
-    .describe('Slug');
-export const zBaseDBEntity = z
-    .object({
-    id: z.string(),
-    // created/updated are intentionally optional here
-    created: zUnixTimestamp2000.optional(),
-    updated: zUnixTimestamp2000.optional(),
-})
-    .describe('BaseDBEntity');
-// export const zSavedDBEntity = zBaseDBEntity.required().describe('SavedDBEntity')

package/dist-esm/zod/zod.util.js

@@ -1,52 +0,0 @@
-import { ZodError } from 'zod';
-import { _stringify } from '../string/stringify';
-export function zIsValid(value, schema) {
-    const { success } = schema.safeParse(value);
-    return success;
-}
-export function zValidate(value, schema) {
-    const r = zSafeValidate(value, schema);
-    if (r.success) {
-        return r.data;
-    }
-    throw r.error;
-}
-export function zSafeValidate(value, schema) {
-    const r = schema.safeParse(value);
-    if (r.success) {
-        return r;
-    }
-    return {
-        success: false,
-        error: new ZodValidationError(r.error.issues, value, schema),
-    };
-}
-export class ZodValidationError extends ZodError {
-    constructor(issues, value, schema) {
-        super(issues);
-        this.value = value;
-        this.schema = schema;
-    }
-    get message() {
-        return this.annotate();
-    }
-    annotate() {
-        let objectTitle = this.schema.description;
-        if (typeof this.value === 'object' && this.value) {
-            const objectName = this.schema.description || this.value.constructor?.name;
-            const objectId = this.value['id'];
-            objectTitle = [objectName, objectId].filter(Boolean).join('.');
-        }
-        objectTitle || (objectTitle = 'data');
-        return [
-            `Invalid ${objectTitle}`,
-            '',
-            'Input:',
-            _stringify(this.value),
-            this.issues.length > 1 ? `\n${this.issues.length} issues:` : '',
-            ...this.issues.slice(0, 100).map(i => {
-                return [i.path.join('.'), i.message].filter(Boolean).join(': ');
-            }),
-        ].join('\n');
-    }
-}