core-services-sdk 1.3.36 → 1.3.38

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "core-services-sdk",
-  "version": "1.3.36",
+  "version": "1.3.38",
   "main": "src/index.js",
   "type": "module",
   "types": "types/index.d.ts",
@@ -10,7 +10,7 @@
     "test": "vitest run --coverage",
     "format": "prettier --write .",
     "bump": "node ./scripts/bump-version.js",
-    "build:types": "tsc --declaration --allowJs --emitDeclarationOnly --outDir types ./src/index.js"
+    "build:types": "tsc --project tsconfig.json && prettier --write ."
   },
   "repository": {
     "type": "git",

package/src/fastify/error-codes.js

@@ -5,14 +5,12 @@ import httpStatus from 'http-status'
  * Useful as a fallback error descriptor for unhandled or unexpected failures.
  *
  * @typedef {Object} GeneralError
- * @property {number} httpStatusCode - The HTTP status code (500).
- * @property {string} httpStatusText - The human-readable status text ("Internal Server Error").
+ * @property {number} status - The HTTP status code (500).
  * @property {string} code - An application-specific error code in the format "GENERAL.<StatusText>".
  */
 
 /** @type {GeneralError} */
 export const GENERAL_ERROR = {
-  httpStatusCode: httpStatus.INTERNAL_SERVER_ERROR,
-  httpStatusText: httpStatus[httpStatus.INTERNAL_SERVER_ERROR],
+  status: httpStatus.INTERNAL_SERVER_ERROR,
   code: `GENERAL.${httpStatus[httpStatus.INTERNAL_SERVER_ERROR]}`,
 }

package/src/fastify/error-handlers/with-error-handling.js

@@ -48,8 +48,8 @@ export const withErrorHandlingReply =
     try {
       return await withErrorHandling(log, defaultError)(funcToInvoke)
     } catch (error) {
-      const { code, httpStatusText, httpStatusCode } = error
-      reply.status(httpStatusCode).send({ code, httpStatusText })
+      const { code, status } = error
+      reply.status(status).send({ code })
     }
   }
 
@@ -81,12 +81,11 @@ export const replyOnErrorOnly =
         errorMerged.stack = error.stack
       }
 
-      const exposed =
-        errorMerged.message ?? errorMerged.code ?? GENERAL_ERROR.httpStatusText
+      const exposed = errorMerged.message ?? errorMerged.code
 
       const status =
-        errorMerged.httpStatusCode && errorMerged.httpStatusCode in httpStatus
-          ? errorMerged.httpStatusCode
+        errorMerged.status && errorMerged.status in httpStatus
+          ? errorMerged.status
           : httpStatus.INTERNAL_SERVER_ERROR
 
       reply.status(status).send({ error: exposed })

package/src/http/HttpError.js

@@ -15,13 +15,7 @@ export class HttpError extends Error {
    * @type {number | undefined}
    * HTTP status code associated with the error (e.g., 400, 500).
    */
-  httpStatusCode
-
-  /**
-   * @type {string | undefined}
-   * Human-readable HTTP status text (e.g., "Bad Request").
-   */
-  httpStatusText
+  status
 
   /**
    * @type {object | undefined}
@@ -35,24 +29,16 @@ export class HttpError extends Error {
    * @param {Object} [error] - Optional error object.
    * @param {string | number} [error.code] - Application-specific error code.
    * @param {string} [error.message] - Custom error message.
-   * @param {number} [error.httpStatusCode] - HTTP status code (e.g., 404, 500).
-   * @param {string} [error.httpStatusText] - Optional human-readable HTTP status text.
+   * @param {number} [error.status] - HTTP status code (e.g., 404, 500).
    * @param {object} [error.extendInfo] - Optional extended metadata for diagnostics.
    */
   constructor(error = {}) {
-    const { code, message, httpStatusCode, httpStatusText, extendInfo } = error
+    const { code, status, message, extendInfo } = error
 
-    super(
-      message ||
-        (httpStatusCode && httpStatus[httpStatusCode]) ||
-        code ||
-        'Unknown error',
-    )
+    super(message || (status && httpStatus[status]) || code || 'Unknown error')
 
     this.code = code
-    this.httpStatusCode = httpStatusCode
-    this.httpStatusText =
-      httpStatusText || (httpStatusCode && httpStatus[httpStatusCode])
+    this.status = status
     this.extendInfo = extendInfo
 
     if (typeof Error.captureStackTrace === 'function') {
@@ -81,8 +67,7 @@ export class HttpError extends Error {
       instance &&
       typeof instance === 'object' &&
       'message' in instance &&
-      'httpStatusCode' in instance &&
-      'httpStatusText' in instance
+      'status' in instance
     )
   }
 
@@ -92,8 +77,7 @@ export class HttpError extends Error {
    * @returns {{
    *   code: string | number | undefined,
    *   message: string,
-   *   httpStatusCode: number | undefined,
-   *   httpStatusText: string | undefined,
+   *   status: number | undefined,
    *   extendInfo?: object
    * }}
    */
@@ -101,8 +85,7 @@ export class HttpError extends Error {
     return {
       code: this.code,
       message: this.message,
-      httpStatusCode: this.httpStatusCode,
-      httpStatusText: this.httpStatusText,
+      status: this.status,
       ...(this.extendInfo ? { extendInfo: this.extendInfo } : {}),
     }
   }
@@ -118,8 +101,7 @@ export class HttpError extends Error {
       error instanceof HttpError ||
       (error &&
         typeof error === 'object' &&
-        'httpStatusCode' in error &&
-        'httpStatusText' in error &&
+        'status' in error &&
         'toJSON' in error)
     )
   }
@@ -138,8 +120,7 @@ export class HttpError extends Error {
     const httpError = new HttpError({
       code: 'UNHANDLED_ERROR',
       message: error.message || 'An unexpected error occurred',
-      httpStatusCode: httpStatus.INTERNAL_SERVER_ERROR,
-      httpStatusText: httpStatus[httpStatus.INTERNAL_SERVER_ERROR],
+      status: httpStatus.INTERNAL_SERVER_ERROR,
     })
 
     httpError.stack = error.stack

package/src/http/http.js

@@ -36,11 +36,10 @@ const isOkStatus = ({ status }) =>
 const checkStatus = async (response) => {
   if (!isOkStatus(response)) {
     const text = await response.text()
-    const { status, statusText } = response
+    const { status } = response
     throw new HttpError({
+      status,
       code: status,
-      httpStatusCode: status,
-      httpStatusText: statusText,
       extendInfo: { text },
     })
   }

package/tests/fastify/error-handler.unit.test.js

@@ -5,13 +5,7 @@ import { GENERAL_ERROR } from '../../src/fastify/error-codes.js'
 
 describe('GENERAL_ERROR', () => {
   it('should have correct status code', () => {
-    expect(GENERAL_ERROR.httpStatusCode).toBe(httpStatus.INTERNAL_SERVER_ERROR)
-  })
-
-  it('should have correct status text', () => {
-    expect(GENERAL_ERROR.httpStatusText).toBe(
-      httpStatus[httpStatus.INTERNAL_SERVER_ERROR],
-    )
+    expect(GENERAL_ERROR.status).toBe(httpStatus.INTERNAL_SERVER_ERROR)
   })
 
   it('should have correct code format', () => {
@@ -22,15 +16,13 @@ describe('GENERAL_ERROR', () => {
   })
 
   it('should have all required properties and types', () => {
-    expect(typeof GENERAL_ERROR.httpStatusCode).toBe('number')
-    expect(typeof GENERAL_ERROR.httpStatusText).toBe('string')
+    expect(typeof GENERAL_ERROR.status).toBe('number')
     expect(typeof GENERAL_ERROR.code).toBe('string')
   })
 
   it('should match full expected structure', () => {
     const expected = {
-      httpStatusCode: 500,
-      httpStatusText: 'Internal Server Error',
+      status: httpStatus.INTERNAL_SERVER_ERROR,
       code: 'GENERAL.Internal Server Error',
     }
 

package/tests/fastify/error-handlers/with-error-handling.test.js

@@ -25,7 +25,7 @@ describe('withErrorHandling', () => {
   it('should rethrow HttpError', async () => {
     const err = new HttpError({
       message: 'Bad',
-      httpStatusCode: httpStatus.BAD_REQUEST,
+      status: httpStatus.BAD_REQUEST,
     })
     const fn = vi.fn().mockRejectedValue(err)
 
@@ -65,8 +65,7 @@ describe('withErrorHandlingReply', () => {
     const err = new HttpError({
       message: 'not found',
       code: 'NOT_FOUND',
-      httpStatusCode: httpStatus.NOT_FOUND,
-      httpStatusText: httpStatus[httpStatus.NOT_FOUND],
+      status: httpStatus.NOT_FOUND,
     })
 
     const fn = vi.fn().mockRejectedValue(err)
@@ -75,7 +74,6 @@ describe('withErrorHandlingReply', () => {
     expect(reply.status).toHaveBeenCalledWith(httpStatus.NOT_FOUND)
     expect(reply.send).toHaveBeenCalledWith({
       code: 'NOT_FOUND',
-      httpStatusText: 'Not Found',
     })
   })
 })
@@ -112,8 +110,7 @@ describe('replyOnErrorOnly', () => {
     const err = new HttpError({
       message: 'forbidden',
       code: 'NO_ACCESS',
-      httpStatusCode: httpStatus.FORBIDDEN,
-      httpStatusText: httpStatus[httpStatus.FORBIDDEN],
+      status: httpStatus.FORBIDDEN,
     })
 
     const fn = vi.fn().mockRejectedValue(err)

package/tests/http/HttpError.unit.test.js

@@ -8,26 +8,24 @@ describe('HttpError', () => {
     const error = new HttpError({
       code: 'INVALID_INPUT',
       message: 'Invalid input provided',
-      httpStatusCode: 400,
+      status: httpStatus.BAD_REQUEST,
       extendInfo: { field: 'email', reason: 'missing' },
     })
 
     expect(error).toBeInstanceOf(HttpError)
     expect(error.message).toBe('Invalid input provided')
     expect(error.code).toBe('INVALID_INPUT')
-    expect(error.httpStatusCode).toBe(400)
-    expect(error.httpStatusText).toBe(httpStatus[400])
+    expect(error.status).toBe(httpStatus.BAD_REQUEST)
     expect(error.extendInfo).toEqual({ field: 'email', reason: 'missing' })
   })
 
   it('should fallback to default message from status if message is missing', () => {
     const error = new HttpError({
       code: 'BAD_REQUEST',
-      httpStatusCode: 400,
+      status: httpStatus.BAD_REQUEST,
     })
 
-    expect(error.message).toBe(httpStatus[400])
-    expect(error.httpStatusText).toBe(httpStatus[400])
+    expect(error.message).toBe(httpStatus[httpStatus.BAD_REQUEST])
     expect(error.extendInfo).toBeUndefined()
   })
 
@@ -35,7 +33,7 @@ describe('HttpError', () => {
     const error = new HttpError({ code: 'ERROR_CODE_ONLY' })
 
     expect(error.message).toBe('ERROR_CODE_ONLY')
-    expect(error.httpStatusCode).toBeUndefined()
+    expect(error.status).toBeUndefined()
     expect(error.extendInfo).toBeUndefined()
   })
 
@@ -50,14 +48,13 @@ describe('HttpError', () => {
     const error = new HttpError({
       code: 'NOT_FOUND',
       message: 'Resource not found',
-      httpStatusCode: 404,
+      status: httpStatus.NOT_FOUND,
     })
 
     expect(error.toJSON()).toEqual({
       code: 'NOT_FOUND',
       message: 'Resource not found',
-      httpStatusCode: 404,
-      httpStatusText: httpStatus[404],
+      status: httpStatus.NOT_FOUND,
     })
   })
 
@@ -65,15 +62,14 @@ describe('HttpError', () => {
     const error = new HttpError({
       code: 'NOT_FOUND',
       message: 'Resource not found',
-      httpStatusCode: 404,
+      status: httpStatus.NOT_FOUND,
       extendInfo: { resource: 'user', id: 123 },
     })
 
     expect(error.toJSON()).toEqual({
       code: 'NOT_FOUND',
       message: 'Resource not found',
-      httpStatusCode: 404,
-      httpStatusText: httpStatus[404],
+      status: httpStatus.NOT_FOUND,
       extendInfo: { resource: 'user', id: 123 },
     })
   })
@@ -81,7 +77,7 @@ describe('HttpError', () => {
   it('should detect instance using isHttpError', () => {
     const error = new HttpError({
       code: 'TEST',
-      httpStatusCode: 500,
+      status: httpStatus.INTERNAL_SERVER_ERROR,
     })
 
     expect(HttpError.isHttpError(error)).toBe(true)
@@ -91,7 +87,7 @@ describe('HttpError', () => {
   it('FromError should return same instance if already HttpError', () => {
     const original = new HttpError({
       code: 'ALREADY_HTTP',
-      httpStatusCode: 401,
+      status: httpStatus.UNAUTHORIZED,
     })
     const result = HttpError.FromError(original)
 
@@ -105,8 +101,8 @@ describe('HttpError', () => {
     expect(httpError).toBeInstanceOf(HttpError)
     expect(httpError.message).toBe('Boom!')
     expect(httpError.code).toBe('UNHANDLED_ERROR')
-    expect(httpError.httpStatusCode).toBe(500)
-    expect(httpError.httpStatusText).toBe(httpStatus[500])
+    expect(httpError.status).toBe(httpStatus.INTERNAL_SERVER_ERROR)
+
     expect(httpError.extendInfo).toBeUndefined()
   })
 })

package/tsconfig.json

@@ -3,7 +3,9 @@
     "declaration": true,
     "allowJs": true,
     "emitDeclarationOnly": true,
-    "outDir": "types"
+    "outDir": "types",
+    "esModuleInterop": true,
+    "skipLibCheck": true
   },
   "include": ["src"]
 }

package/types/core/combine-unique-arrays.d.ts

@@ -1 +1 @@
-export function combineUniqueArrays(...lists: Array<any>[]): Array<any>;
+export function combineUniqueArrays(...lists: Array<any>[]): Array<any>

package/types/core/index.d.ts

@@ -1,9 +1,9 @@
-export * from "./regex-utils.js";
-export * from "./otp-generators.js";
-export * from "./sanitize-objects.js";
-export * from "./normalize-min-max.js";
-export * from "./normalize-to-array.js";
-export * from "./combine-unique-arrays.js";
-export * from "./normalize-phone-number.js";
-export * from "./normalize-array-operators.js";
-export * from "./normalize-premitives-types-or-default.js";
+export * from './regex-utils.js'
+export * from './otp-generators.js'
+export * from './sanitize-objects.js'
+export * from './normalize-min-max.js'
+export * from './normalize-to-array.js'
+export * from './combine-unique-arrays.js'
+export * from './normalize-phone-number.js'
+export * from './normalize-array-operators.js'
+export * from './normalize-premitives-types-or-default.js'

package/types/core/normalize-array-operators.d.ts

@@ -1 +1 @@
-export function normalizeOperators(obj: any): any;
+export function normalizeOperators(obj: any): any

package/types/core/normalize-min-max.d.ts

@@ -1,10 +1,16 @@
-export function normalizeMinMax(defaultMinMax: {
-    min: number;
-    max: number;
-}, valuesMinMax: {
-    min?: number;
-    max?: number;
-} | null | undefined): {
-    min: number;
-    max: number;
-};
+export function normalizeMinMax(
+  defaultMinMax: {
+    min: number
+    max: number
+  },
+  valuesMinMax:
+    | {
+        min?: number
+        max?: number
+      }
+    | null
+    | undefined,
+): {
+  min: number
+  max: number
+}

package/types/core/normalize-phone-number.d.ts

@@ -1,6 +1,6 @@
 /** Resolve libphonenumber regardless of interop shape */
-export function getLib(): any;
-export function phoneUtil(): any;
+export function getLib(): any
+export function phoneUtil(): any
 /**
  * Parse & validate an international number (must start with '+').
  * @param {string} input
@@ -8,12 +8,12 @@ export function phoneUtil(): any;
  * @throws {Error} If the number is invalid
  */
 export function normalizePhoneOrThrowIntl(input: string): {
-    e164: string;
-    national: string;
-    international: string;
-    regionCode: string | undefined;
-    type: number;
-};
+  e164: string
+  national: string
+  international: string
+  regionCode: string | undefined
+  type: number
+}
 /**
  * Parse & validate a national number using a region hint.
  * @param {string} input
@@ -21,13 +21,16 @@ export function normalizePhoneOrThrowIntl(input: string): {
  * @returns {{e164:string,national:string,international:string,regionCode:string|undefined,type:number}}
  * @throws {Error} If the number is invalid
  */
-export function normalizePhoneOrThrowWithRegion(input: string, defaultRegion: string): {
-    e164: string;
-    national: string;
-    international: string;
-    regionCode: string | undefined;
-    type: number;
-};
+export function normalizePhoneOrThrowWithRegion(
+  input: string,
+  defaultRegion: string,
+): {
+  e164: string
+  national: string
+  international: string
+  regionCode: string | undefined
+  type: number
+}
 /**
  * Smart normalization:
  * - If input starts with '+', parse as international.
@@ -37,12 +40,15 @@ export function normalizePhoneOrThrowWithRegion(input: string, defaultRegion: st
  * @returns {{e164:string,national:string,international:string,regionCode:string|undefined,type:number}}
  * @throws {Error} If invalid or defaultRegion is missing for non-international input
  */
-export function normalizePhoneOrThrow(input: string, opts?: {
-    defaultRegion?: string;
-}): {
-    e164: string;
-    national: string;
-    international: string;
-    regionCode: string | undefined;
-    type: number;
-};
+export function normalizePhoneOrThrow(
+  input: string,
+  opts?: {
+    defaultRegion?: string
+  },
+): {
+  e164: string
+  national: string
+  international: string
+  regionCode: string | undefined
+  type: number
+}

package/types/core/normalize-premitives-types-or-default.d.ts

@@ -53,7 +53,11 @@
  *   {}
  * )
  */
-export function normalizeOrDefault<T>(value: any, isValid: (v: any) => boolean, defaultValue: T): T;
+export function normalizeOrDefault<T>(
+  value: any,
+  isValid: (v: any) => boolean,
+  defaultValue: T,
+): T
 /**
  * Normalize a value to a non-empty, trimmed string; otherwise return a default (also trimmed).
  *
@@ -93,7 +97,10 @@ export function normalizeOrDefault<T>(value: any, isValid: (v: any) => boolean,
  * normalizeStringOrDefault(42, 'user-roles-management:edit')
  * // → 'user-roles-management:edit'
  */
-export function normalizeStringOrDefault(value: any, defaultValue: string): string;
+export function normalizeStringOrDefault(
+  value: any,
+  defaultValue: string,
+): string
 /**
  * Normalize a value to a valid number (with safe string coercion); otherwise return a default.
  *
@@ -131,7 +138,10 @@ export function normalizeStringOrDefault(value: any, defaultValue: string): stri
  * normalizeNumberOrDefault(NaN, 7)      // → 7
  * normalizeNumberOrDefault({}, 7)       // → 7
  */
-export function normalizeNumberOrDefault(value: any, defaultValue: number): number;
+export function normalizeNumberOrDefault(
+  value: any,
+  defaultValue: number,
+): number
 /**
  * Normalize a value to a boolean (with "true"/"false" string support); otherwise return a default.
  *
@@ -169,4 +179,7 @@ export function normalizeNumberOrDefault(value: any, defaultValue: number): numb
  * normalizeBooleanOrDefault('yes',  false) // → false  (rejected → default)
  * normalizeBooleanOrDefault(1,      true)  // → true   (rejected → default)
  */
-export function normalizeBooleanOrDefault(value: any, defaultValue: boolean): boolean;
+export function normalizeBooleanOrDefault(
+  value: any,
+  defaultValue: boolean,
+): boolean

package/types/core/normalize-to-array.d.ts

@@ -1 +1 @@
-export function normalizeToArray(value: any): string[];
+export function normalizeToArray(value: any): string[]

package/types/core/otp-generators.d.ts

@@ -11,46 +11,50 @@
  * @throws {Error} If charset is provided and is not a non-empty string.
  * @throws {Error} If the type is invalid and no valid charset is provided.
  */
-export function generateCode({ length, type, charset }?: {
-    length?: number;
-    type?: string;
-    charset?: string;
-}): string;
+export function generateCode({
+  length,
+  type,
+  charset,
+}?: {
+  length?: number
+  type?: string
+  charset?: string
+}): string
 /**
  * Generates an OTP code using alphabetic characters (both lowercase and uppercase).
  *
  * @param {number} [length=4] - The desired length of the code.
  * @returns {string} The generated code.
  */
-export function generateCodeAlpha(length?: number): string;
+export function generateCodeAlpha(length?: number): string
 /**
  * Generates an OTP code using only numeric digits (0-9).
  *
  * @param {number} [length=4] - The desired length of the code.
  * @returns {string} The generated code.
  */
-export function generateCodeDigits(length?: number): string;
+export function generateCodeDigits(length?: number): string
 /**
  * Generates an OTP code using alphabetic characters and digits.
  *
  * @param {number} [length=4] - The desired length of the code.
  * @returns {string} The generated code.
  */
-export function generateCodeAlphaNumeric(length?: number): string;
+export function generateCodeAlphaNumeric(length?: number): string
 /**
  * Generates an OTP code using alphabetic characters, digits, and symbols.
  *
  * @param {number} [length=4] - The desired length of the code.
  * @returns {string} The generated code.
  */
-export function generateCodeAlphaNumericSymbols(length?: number): string;
+export function generateCodeAlphaNumericSymbols(length?: number): string
 export const OTP_GENERATOR_TYPES: Readonly<{
-    any: "any";
-    alpha: "alpha";
-    numeric: "numeric";
-    symbols: "symbols";
-    alphaLower: "alphaLower";
-    alphaUpper: "alphaUpper";
-    alphanumeric: "alphanumeric";
-    alphanumericSymbols: "alphanumericSymbols";
-}>;
+  any: 'any'
+  alpha: 'alpha'
+  numeric: 'numeric'
+  symbols: 'symbols'
+  alphaLower: 'alphaLower'
+  alphaUpper: 'alphaUpper'
+  alphanumeric: 'alphanumeric'
+  alphanumericSymbols: 'alphanumericSymbols'
+}>

package/types/core/regex-utils.d.ts

@@ -1 +1 @@
-export function isValidRegex(pattern: string | RegExp): boolean;
+export function isValidRegex(pattern: string | RegExp): boolean

package/types/core/sanitize-objects.d.ts

@@ -1,4 +1,13 @@
-export function sanitizeObject(obj: any, filter: (entry: [string, any]) => boolean): any;
-export function sanitizeUndefinedFields(obj: any): any;
-export function sanitizeObjectAllowProps(obj: any, allowedFields?: string[]): any;
-export function sanitizeObjectDisallowProps(obj: any, disallowedFields?: string[]): any;
+export function sanitizeObject(
+  obj: any,
+  filter: (entry: [string, any]) => boolean,
+): any
+export function sanitizeUndefinedFields(obj: any): any
+export function sanitizeObjectAllowProps(
+  obj: any,
+  allowedFields?: string[],
+): any
+export function sanitizeObjectDisallowProps(
+  obj: any,
+  disallowedFields?: string[],
+): any