@artinet/sdk/dist/browser/utils/utils.js

A TypeScript SDK for building collaborative AI agents.

/**
 * Copyright 2025 The Artinet Project
 * SPDX-License-Identifier: Apache-2.0
 */
import escapeHtml from 'escape-html';
import { Buffer } from 'node:buffer';
/**
 * Sanitizes a string by escaping HTML characters to prevent XSS attacks.
 * @param str - The string to sanitize.
 * @returns The sanitized string.
 */
export function sanitizeString(str) {
    return escapeHtml(str).trim();
}
/**
 * Generates a timestamp in ISO 8601 format.
 * @returns The current timestamp as a string.
 */
export function getCurrentTimestamp() {
    return new Date().toISOString();
}
/**
 * Sleeps for a given number of milliseconds.
 * @param ms - The number of milliseconds to sleep.
 * @returns A promise that resolves when the sleep is complete.
 *
 * @example
 * ```typescript
 * await sleep(1000);
 * ```
 */
export function sleep(ms) {
    return new Promise((resolve) => setTimeout(resolve, ms));
}
/**
 * Formats a JSON object into a string with indentation.
 * @param json - The JSON object to format.
 * @param replacer - A function that transforms the results.
 * @param space - Adds indentation, white space, and line break characters to the return-value JSON text to make it easier to read.
 * @returns A string representation of the JSON object.
 */
export function formatJson(json, replacer = null, space = 2) {
    return JSON.stringify(json, replacer, space);
}
/**
 * Formats an error into a standard error object for logging.
 * @param error - The error to format.
 * @returns A standard error object.
 */
export function formatError(error) {
    if (error instanceof Error) {
        return error;
    }
    return new Error(String(error));
}
/**
 * Executes a function immediately.
 * @param fn - The function to execute.
 * @returns The result of the function.
 *
 * @example
 * ```typescript
 * const result = iife(() => {
 *   return 1 + 1;
 * });
 * console.log(result); // 2
 * ```
 * LangChain <3
 * @see https://github.com/langchain-ai/langchainjs/blob/981cf9c480925187a524fd6ad1dbf0488d2758eb/libs/langchain-core/src/language_models/utils.ts#L5
 */
export const iife = (fn) => fn();
export function encodeBase64(data) {
    return Buffer.from(data).toString('base64');
}
export function decodeBase64(data) {
    return Buffer.from(data, 'base64').toString();
}