@kyyinfinite/lumina 1.0.0

package/src/utils/validator.js

@@ -0,0 +1,129 @@
+/**
+ * @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',
+    })
+  }
+}
+
+/**
+ * @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',
+    })
+  }
+}
+
+/**
+ * @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',
+    })
+  }
+}
+
+/**
+ * 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)))
+  if (!ok) {
+    throw new ValidationError(`${label} must be a plain object or an array of plain objects`, {
+      code: 'LUMINA_VALIDATION_NOT_OBJECT_OR_ARRAY',
+    })
+  }
+}
+
+/**
+ * @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',
+    })
+  }
+}
+
+/**
+ * @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',
+    })
+  }
+}
+
+/**
+ * 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 } }
+  if (isPlainObject(source)) return { raw: source }
+  throw new ValidationError('media source must be a string, Buffer, or plain object', {
+    code: 'LUMINA_VALIDATION_BAD_MEDIA_SOURCE',
+  })
+}
+
+export default {
+  isPlainObject,
+  ensurePlainObject,
+  ensureString,
+  ensureStringArray,
+  ensureObjectOrArray,
+  ensureBuffer,
+  ensureStringOrBuffer,
+  coerceMediaSource,
+}