Helpers

pnpm add @orion-js/helpers

import { sleep } from '@orion-js/helpers'

// Wait for 1 second
await sleep(1000)

import { executeWithRetries } from '@orion-js/helpers'

// Execute a function with 3 retries and 200ms timeout between attempts
const result = await executeWithRetries(async () => {
  // Your async function that might fail
  return await fetchData()
}, 3, 200)

import { generateId } from '@orion-js/helpers'

// Default 17-character ID using alphanumeric characters
const id = generateId()

// Custom length ID
const shortId = generateId(8)

// Custom character set
const numericId = generateId(10, '0123456789')

import { generateUUID } from '@orion-js/helpers'

const uuid = generateUUID()

import { hashObject } from '@orion-js/helpers'

const hash = hashObject({ key: 'value' })

import { createMap } from '@orion-js/helpers'

const users = [
  { id: 1, name: 'John' },
  { id: 2, name: 'Jane' }
]

// Creates: { 1: { id: 1, name: 'John' }, 2: { id: 2, name: 'Jane' } }
const userMap = createMap(users, 'id')

import { createMapArray } from '@orion-js/helpers'

const posts = [
  { userId: 1, text: 'Post 1' },
  { userId: 1, text: 'Post 2' },
  { userId: 2, text: 'Post 3' }
]

// Creates: { 1: [{ userId: 1, text: 'Post 1' }, { userId: 1, text: 'Post 2' }], 2: [{ userId: 2, text: 'Post 3' }] }
const postsByUser = createMapArray(posts, 'userId')

import { composeMiddlewares } from '@orion-js/helpers'

const middleware1 = async (ctx, next) => {
  // Do something before
  await next()
  // Do something after
}

const middleware2 = async (ctx, next) => {
  // Another middleware
  await next()
}

const composedMiddleware = composeMiddlewares([middleware1, middleware2])

// Use the composed middleware
await composedMiddleware(context)

import { OrionError } from '@orion-js/helpers'

throw new OrionError('Something went wrong')

import { UserError } from '@orion-js/helpers'

// Basic usage
throw new UserError('Invalid input')

// With error code
throw new UserError('invalid_input', 'Please provide a valid email')

// With extra data
throw new UserError('invalid_input', 'Please provide a valid email', { field: 'email' })

import { PermissionsError } from '@orion-js/helpers'

throw new PermissionsError('You do not have permission to delete this item')

try {
  // ...
} catch (error) {
  if (error.isOrionError) {
    // Get standardized error information
    const info = error.getInfo()
    console.log(info.error) // Error code
    console.log(info.message) // Error message
    console.log(info.extra) // Extra data
    
    if (error.isUserError) {
      // Can be shown to the user
    }
    
    if (error.isPermissionsError) {
      // Handle permissions issues
    }
  }
}