durable-execution/src/utils.ts

A durable task engine for running tasks durably and resiliently

import type { StandardSchemaV1 } from '@standard-schema/spec'
import { getDotPath } from '@standard-schema/utils'
import { customAlphabet } from 'nanoid'

import { sleep } from '@gpahal/std/promises'

/**
 * Sleep with jitter.
 *
 * @param ms - The time to sleep.
 * @returns A promise that resolves after the time has passed.
 */
export function sleepWithJitter(ms: number): Promise<void> {
  return sleep(ms * (0.5 + Math.random()))
}

const _ALPHABET = '0123456789ABCDEFGHJKMNPQRSTUVWXYZabcdefghjkmnpqrstuvwxyz'

/**
 * Generate a random id.
 *
 * @param size - The length of the id. If not provided, it will be 24.
 * @returns A random id.
 */
export const generateId = customAlphabet(_ALPHABET, 24)

/**
 * Summarize standard schema issues.
 *
 * @param issues - The issues to summarize.
 * @returns A summary of the issues.
 */
export function summarizeStandardSchemaIssues(
  issues: ReadonlyArray<StandardSchemaV1.Issue>,
): string {
  let summary = ''
  for (const issue of issues) {
    if (summary) {
      summary += '\n'
    }

    summary += `× ${issue.message}`
    const dotPath = getDotPath(issue)
    if (dotPath) {
      summary += `\n  → at ${dotPath}`
    }
  }

  return summary
}