tiny-essentials 1.11.0 → 1.12.0

package/README.md

@@ -21,9 +21,6 @@
 - ⏱️ **Time Calculations**: Easily calculate durations, format timers, and more.
 - 🧠 **Object Utilities**: Perform type checks, count object properties, and calculate percentages.
 - 🛠️ **Custom Utilities**: Includes various helper functions like `ruleOfThree` for proportion calculations and `getAge` to calculate the age based on a given birth date.
-- 🔐 **Encryption Tools**:  
-  This feature has been migrated.  
-  👉 For the latest version and full functionality, please visit the new [Tiny Crypto Suite repository](https://github.com/JasminDreasond/Tiny-Crypto-Suite).
 
 ## 📦 Installation
 
@@ -60,6 +57,18 @@ Check out the full documentation here:
 
 👉 [Go to docs page](./docs/v1/README.md)
 
+---
+
+## 📦 More Tiny Essentials Modules
+
+- 🤖 [**tiny-ai-api**](https://github.com/JasminDreasond/Tiny-AI-API) — Minimal AI API wrapper.
+- 🎲 [**tiny-dices**](https://github.com/JasminDreasond/Tiny-Dices) — Simple dice and randomness utilities.
+- 🔐 [**tiny-crypto-suite**](https://github.com/JasminDreasond/Tiny-Crypto-Suite) — Lightweight cryptography toolkit.
+- 🖥️ [**tiny-server-essentials**](https://github.com/JasminDreasond/Tiny-Server-Essentials) — Node.js server utilities.
+- 🪟 [**tiny-electron-essentials**](https://github.com/JasminDreasond/Tiny-Electron-Essentials) — Essential tools for Electron apps.
+
+---
+
 ## 🤝 Contributions
 
 Feel free to fork, contribute, and create pull requests for improvements! Whether it's a bug fix or an additional feature, contributions are always welcome.

package/dist/node_modules/firebase-functions/lib/common/trace.cjs

@@ -0,0 +1,82 @@
+'use strict';
+
+var trace = require('../../../../_virtual/trace.cjs');
+var require$$0 = require('async_hooks');
+
+var hasRequiredTrace;
+
+function requireTrace () {
+	if (hasRequiredTrace) return trace.__exports;
+	hasRequiredTrace = 1;
+	Object.defineProperty(trace.__exports, "__esModule", { value: true });
+	trace.__exports.extractTraceContext = trace.__exports.traceContext = void 0;
+	const async_hooks_1 = require$$0;
+	/* @internal */
+	trace.__exports.traceContext = new async_hooks_1.AsyncLocalStorage();
+	/**
+	 * A regex to match the Cloud Trace header.
+	 *   - ([A-Fa-f0-9]{32}): The trace id, a 32 character hex value. (e.g. 4bf92f3577b34da6a3ce929d0e0e4736)
+	 *   - ([0-9]+): The parent span id, a 64 bit integer. (e.g. 00f067aa0ba902b7)
+	 *   - (?:;o=([0-3])): The trace mask, 1-3 denote it should be traced.
+	 */
+	const CLOUD_TRACE_REGEX = new RegExp("^(?<traceId>[A-Fa-f0-9]{32})/" + "(?<parentIdInt>[0-9]+)" + "(?:;o=(?<traceMask>[0-3]))?$");
+	const CLOUD_TRACE_HEADER = "X-Cloud-Trace-Context";
+	function matchCloudTraceHeader(carrier) {
+	    let header = carrier === null || carrier === void 0 ? void 0 : carrier[CLOUD_TRACE_HEADER];
+	    if (!header) {
+	        // try lowercase header
+	        header = carrier === null || carrier === void 0 ? void 0 : carrier[CLOUD_TRACE_HEADER.toLowerCase()];
+	    }
+	    if (header && typeof header === "string") {
+	        const matches = CLOUD_TRACE_REGEX.exec(header);
+	        if (matches && matches.groups) {
+	            const { traceId, parentIdInt, traceMask } = matches.groups;
+	            // Convert parentId from unsigned int to hex
+	            const parentId = parseInt(parentIdInt);
+	            if (isNaN(parentId)) {
+	                // Ignore traces with invalid parentIds
+	                return;
+	            }
+	            const sample = !!traceMask && traceMask !== "0";
+	            return { traceId, parentId: parentId.toString(16), sample, version: "00" };
+	        }
+	    }
+	}
+	/**
+	 * A regex to match the traceparent header.
+	 *   - ^([a-f0-9]{2}): The specification version (e.g. 00)
+	 *   - ([a-f0-9]{32}): The trace id, a 16-byte array. (e.g. 4bf92f3577b34da6a3ce929d0e0e4736)
+	 *   - ([a-f0-9]{16}): The parent span id, an 8-byte array. (e.g. 00f067aa0ba902b7)
+	 *   - ([a-f0-9]{2}: The sampled flag. (e.g. 00)
+	 */
+	const TRACEPARENT_REGEX = new RegExp("^(?<version>[a-f0-9]{2})-" +
+	    "(?<traceId>[a-f0-9]{32})-" +
+	    "(?<parentId>[a-f0-9]{16})-" +
+	    "(?<flag>[a-f0-9]{2})$");
+	const TRACEPARENT_HEADER = "traceparent";
+	function matchTraceparentHeader(carrier) {
+	    const header = carrier === null || carrier === void 0 ? void 0 : carrier[TRACEPARENT_HEADER];
+	    if (header && typeof header === "string") {
+	        const matches = TRACEPARENT_REGEX.exec(header);
+	        if (matches && matches.groups) {
+	            const { version, traceId, parentId, flag } = matches.groups;
+	            const sample = flag === "01";
+	            return { traceId, parentId, sample, version };
+	        }
+	    }
+	}
+	/**
+	 * Extracts trace context from given carrier object, if any.
+	 *
+	 * Supports Cloud Trace and traceparent format.
+	 *
+	 * @param carrier
+	 */
+	function extractTraceContext(carrier) {
+	    return matchCloudTraceHeader(carrier) || matchTraceparentHeader(carrier);
+	}
+	trace.__exports.extractTraceContext = extractTraceContext;
+	return trace.__exports;
+}
+
+exports.__require = requireTrace;

package/dist/node_modules/firebase-functions/lib/logger/common.cjs

@@ -0,0 +1,57 @@
+'use strict';
+
+var common = require('../../../../_virtual/common.cjs');
+
+var hasRequiredCommon;
+
+function requireCommon () {
+	if (hasRequiredCommon) return common.__exports;
+	hasRequiredCommon = 1;
+	// The MIT License (MIT)
+	//
+	// Copyright (c) 2017 Firebase
+	//
+	// Permission is hereby granted, free of charge, to any person obtaining a copy
+	// of this software and associated documentation files (the "Software"), to deal
+	// in the Software without restriction, including without limitation the rights
+	// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+	// copies of the Software, and to permit persons to whom the Software is
+	// furnished to do so, subject to the following conditions:
+	//
+	// The above copyright notice and this permission notice shall be included in all
+	// copies or substantial portions of the Software.
+	//
+	// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+	// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+	// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+	// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+	// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+	// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+	// SOFTWARE.
+	Object.defineProperty(common.__exports, "__esModule", { value: true });
+	common.__exports.UNPATCHED_CONSOLE = common.__exports.CONSOLE_SEVERITY = void 0;
+	// Map LogSeverity types to their equivalent `console.*` method.
+	/** @hidden */
+	common.__exports.CONSOLE_SEVERITY = {
+	    DEBUG: "debug",
+	    INFO: "info",
+	    NOTICE: "info",
+	    WARNING: "warn",
+	    ERROR: "error",
+	    CRITICAL: "error",
+	    ALERT: "error",
+	    EMERGENCY: "error",
+	};
+	// safely preserve unpatched console.* methods in case of compat require
+	/** @hidden */
+	common.__exports.UNPATCHED_CONSOLE = {
+	    debug: console.debug,
+	    info: console.info,
+	    log: console.log,
+	    warn: console.warn,
+	    error: console.error,
+	};
+	return common.__exports;
+}
+
+exports.__require = requireCommon;

package/dist/node_modules/firebase-functions/lib/logger/index.cjs

@@ -0,0 +1,158 @@
+'use strict';
+
+var index = require('../../../../_virtual/index2.cjs');
+var require$$0 = require('util');
+var trace = require('../common/trace.cjs');
+var common = require('./common.cjs');
+
+var hasRequiredLogger;
+
+function requireLogger () {
+	if (hasRequiredLogger) return index.__exports;
+	hasRequiredLogger = 1;
+	// The MIT License (MIT)
+	//
+	// Copyright (c) 2017 Firebase
+	//
+	// Permission is hereby granted, free of charge, to any person obtaining a copy
+	// of this software and associated documentation files (the "Software"), to deal
+	// in the Software without restriction, including without limitation the rights
+	// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+	// copies of the Software, and to permit persons to whom the Software is
+	// furnished to do so, subject to the following conditions:
+	//
+	// The above copyright notice and this permission notice shall be included in all
+	// copies or substantial portions of the Software.
+	//
+	// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+	// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+	// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+	// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+	// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+	// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+	// SOFTWARE.
+	Object.defineProperty(index.__exports, "__esModule", { value: true });
+	index.__exports.error = index.__exports.warn = index.__exports.info = index.__exports.log = index.__exports.debug = index.__exports.write = void 0;
+	const util_1 = require$$0;
+	const trace_1 = trace.__require();
+	const common_1 = common.__require();
+	/** @internal */
+	function removeCircular(obj, refs = []) {
+	    if (typeof obj !== "object" || !obj) {
+	        return obj;
+	    }
+	    // If the object defines its own toJSON, prefer that.
+	    if (obj.toJSON) {
+	        return obj.toJSON();
+	    }
+	    if (refs.includes(obj)) {
+	        return "[Circular]";
+	    }
+	    else {
+	        refs.push(obj);
+	    }
+	    let returnObj;
+	    if (Array.isArray(obj)) {
+	        returnObj = new Array(obj.length);
+	    }
+	    else {
+	        returnObj = {};
+	    }
+	    for (const k in obj) {
+	        if (refs.includes(obj[k])) {
+	            returnObj[k] = "[Circular]";
+	        }
+	        else {
+	            returnObj[k] = removeCircular(obj[k], refs);
+	        }
+	    }
+	    return returnObj;
+	}
+	/**
+	 * Writes a `LogEntry` to `stdout`/`stderr` (depending on severity).
+	 * @param entry - The `LogEntry` including severity, message, and any additional structured metadata.
+	 * @public
+	 */
+	function write(entry) {
+	    const ctx = trace_1.traceContext.getStore();
+	    if (ctx === null || ctx === void 0 ? void 0 : ctx.traceId) {
+	        entry["logging.googleapis.com/trace"] = `projects/${process.env.GCLOUD_PROJECT}/traces/${ctx.traceId}`;
+	    }
+	    common_1.UNPATCHED_CONSOLE[common_1.CONSOLE_SEVERITY[entry.severity]](JSON.stringify(removeCircular(entry)));
+	}
+	index.__exports.write = write;
+	/**
+	 * Writes a `DEBUG` severity log. If the last argument provided is a plain object,
+	 * it is added to the `jsonPayload` in the Cloud Logging entry.
+	 * @param args - Arguments, concatenated into the log message with space separators.
+	 * @public
+	 */
+	function debug(...args) {
+	    write(entryFromArgs("DEBUG", args));
+	}
+	index.__exports.debug = debug;
+	/**
+	 * Writes an `INFO` severity log. If the last argument provided is a plain object,
+	 * it is added to the `jsonPayload` in the Cloud Logging entry.
+	 * @param args - Arguments, concatenated into the log message with space separators.
+	 * @public
+	 */
+	function log(...args) {
+	    write(entryFromArgs("INFO", args));
+	}
+	index.__exports.log = log;
+	/**
+	 * Writes an `INFO` severity log. If the last argument provided is a plain object,
+	 * it is added to the `jsonPayload` in the Cloud Logging entry.
+	 * @param args - Arguments, concatenated into the log message with space separators.
+	 * @public
+	 */
+	function info(...args) {
+	    write(entryFromArgs("INFO", args));
+	}
+	index.__exports.info = info;
+	/**
+	 * Writes a `WARNING` severity log. If the last argument provided is a plain object,
+	 * it is added to the `jsonPayload` in the Cloud Logging entry.
+	 * @param args - Arguments, concatenated into the log message with space separators.
+	 * @public
+	 */
+	function warn(...args) {
+	    write(entryFromArgs("WARNING", args));
+	}
+	index.__exports.warn = warn;
+	/**
+	 * Writes an `ERROR` severity log. If the last argument provided is a plain object,
+	 * it is added to the `jsonPayload` in the Cloud Logging entry.
+	 * @param args - Arguments, concatenated into the log message with space separators.
+	 * @public
+	 */
+	function error(...args) {
+	    write(entryFromArgs("ERROR", args));
+	}
+	index.__exports.error = error;
+	/** @hidden */
+	function entryFromArgs(severity, args) {
+	    let entry = {};
+	    const lastArg = args[args.length - 1];
+	    if (lastArg && typeof lastArg === "object" && lastArg.constructor === Object) {
+	        entry = args.pop();
+	    }
+	    // mimic `console.*` behavior, see https://nodejs.org/api/console.html#console_console_log_data_args
+	    let message = (0, util_1.format)(...args);
+	    if (severity === "ERROR" && !args.find((arg) => arg instanceof Error)) {
+	        message = new Error(message).stack || message;
+	    }
+	    const out = {
+	        ...entry,
+	        severity,
+	    };
+	    if (message) {
+	        out.message = message;
+	    }
+	    return out;
+	}
+	return index.__exports;
+}
+
+exports.__require = requireLogger;