@qucore-dynamic/packages

Backend utilities for QuCore Dynamic services: JWT validation, request ID generation, type-safe responses, and standardized error handling.

Installation

npm install @qucore-dynamic/packages
# or for GitHub
npm install github:qucore-dynamic/qucore-dynamic-packages#main

Usage

1. Generate unique request IDs

import { generateRequestID } from '@qucore-dynamic/packages'

const requestID = generateRequestID()
console.log('Request ID:', requestID)

This is useful for logging and tracing requests across microservices.

---

2. Validate tokens

import { tokensValidator } from '@qucore-dynamic/packages'

const tokens = tokensValidator(process.env.REFRESH_TOKEN, process.env.ACCESS_TOKEN, {
  accessSecret,
  refreshSecret,
})

if (!tokens.isValid) {
  console.log('Invalid token:', tokens.errorName)
}

---

3. Send standardized responses

import { Response } from 'express'
import { sendResponse } from '@qucore-dynamic/packages'

sendResponse(res, {
  status: 201,
  message: 'User created successfully',
  data: { userId: 123 },
  cookies: [{ name: 'accessToken', value: '...', options: { httpOnly: true, path: '/' } }],
})

sendResponse automatically formats your response as:

{
  "code": "CREATED",
  "message": "User created successfully",
  "details": {
    "data": { "userId": 123 },
    "timestamp": "2026-04-06T18:50:39.781Z"
  }
}

---

4. Throw standardized errors

import { throwError } from '@qucore-dynamic/packages'

throwError({
  rayID: generateRequestID(),
  status: 403,
  code: 'ALREADY_REGISTERED',
  message: 'User is already registered',
})

Throws an object compatible with sendResponse/middleware logging.\

Example output:

{
  "status": 403,
  "code": "ALREADY_REGISTERED",
  "message": "User is already registered",
  "details": {
    "timestamp": "2026-04-06T18:50:39.781Z",
    "rayID": "abcd-1234-efgh"
  }
}

License

GPL-3.0