@kyyinfinite/lumina 1.0.0 → 1.0.2

package/src/utils/validator.js

@@ -1,72 +1,29 @@
-/**
- * @file validator.js
- * @module lumina/utils/validator
- *
- * Centralised input validators. Every "must be a plain object" check that
- * was duplicated 5x in `_build-m.js` is now `ensurePlainObject` / `ensureObjectOrArray`.
- */
-
 import { ValidationError } from '../errors.js'
 
-/**
- * @param {unknown} v
- * @returns {boolean}  True when `v` is a non-null, non-array plain object.
- */
 export function isPlainObject(v) {
   return typeof v === 'object' && v !== null && !Array.isArray(v)
 }
 
-/**
- * @param {unknown} v
- * @param {string} label  Human-readable field name for the error message.
- * @throws {ValidationError}  When `v` is not a plain object.
- */
 export function ensurePlainObject(v, label) {
   if (!isPlainObject(v)) {
-    throw new ValidationError(`${label} must be a plain object`, {
-      code: 'LUMINA_VALIDATION_NOT_OBJECT',
-    })
+    throw new ValidationError(`${label} must be a plain object`, { code: 'LUMINA_VALIDATION_NOT_OBJECT' })
   }
 }
 
-/**
- * @param {unknown} v
- * @param {string} label
- * @throws {ValidationError}
- */
 export function ensureString(v, label) {
   if (typeof v !== 'string') {
-    throw new ValidationError(`${label} must be a string`, {
-      code: 'LUMINA_VALIDATION_NOT_STRING',
-    })
+    throw new ValidationError(`${label} must be a string`, { code: 'LUMINA_VALIDATION_NOT_STRING' })
   }
 }
 
-/**
- * @param {unknown} v
- * @param {string} label
- * @throws {ValidationError}
- */
 export function ensureStringArray(v, label) {
   if (!Array.isArray(v) || !v.every((x) => typeof x === 'string')) {
-    throw new ValidationError(`${label} must be an array of strings`, {
-      code: 'LUMINA_VALIDATION_NOT_STRING_ARRAY',
-    })
+    throw new ValidationError(`${label} must be an array of strings`, { code: 'LUMINA_VALIDATION_NOT_STRING_ARRAY' })
   }
 }
 
-/**
- * Accept either a plain object OR an array of plain objects.
- * Replaces the duplicated validation block in AIRich.addReels/addProduct/addPost.
- *
- * @param {unknown} v
- * @param {string} label
- * @throws {ValidationError}
- */
 export function ensureObjectOrArray(v, label) {
-  const ok =
-    isPlainObject(v) ||
-    (Array.isArray(v) && v.every((x) => isPlainObject(x)))
+  const ok = isPlainObject(v) || (Array.isArray(v) && v.every((x) => isPlainObject(x)))
   if (!ok) {
     throw new ValidationError(`${label} must be a plain object or an array of plain objects`, {
       code: 'LUMINA_VALIDATION_NOT_OBJECT_OR_ARRAY',
@@ -74,40 +31,18 @@ export function ensureObjectOrArray(v, label) {
   }
 }
 
-/**
- * @param {unknown} v
- * @param {string} label
- * @throws {ValidationError}
- */
 export function ensureBuffer(v, label) {
   if (!Buffer.isBuffer(v)) {
-    throw new ValidationError(`${label} must be a Buffer`, {
-      code: 'LUMINA_VALIDATION_NOT_BUFFER',
-    })
+    throw new ValidationError(`${label} must be a Buffer`, { code: 'LUMINA_VALIDATION_NOT_BUFFER' })
   }
 }
 
-/**
- * @param {unknown} v
- * @param {string} label
- * @throws {ValidationError}
- */
 export function ensureStringOrBuffer(v, label) {
   if (typeof v !== 'string' && !Buffer.isBuffer(v)) {
-    throw new ValidationError(`${label} must be a string or Buffer`, {
-      code: 'LUMINA_VALIDATION_NOT_STRING_OR_BUFFER',
-    })
+    throw new ValidationError(`${label} must be a string or Buffer`, { code: 'LUMINA_VALIDATION_NOT_STRING_OR_BUFFER' })
   }
 }
 
-/**
- * Coerce "anything that looks like media" into a uniform source descriptor.
- * Replaces the `Buffer.isBuffer(path) ? path : { url: path }` pattern that
- * was duplicated 5x across the legacy Button setters.
- *
- * @param {string | Buffer | object} source
- * @returns {{ buffer?: Buffer, url?: string, raw: object }}
- */
 export function coerceMediaSource(source) {
   if (Buffer.isBuffer(source)) return { buffer: source, raw: source }
   if (typeof source === 'string') return { url: source, raw: { url: source } }