Add initial project files

apps/backend/app/validators/rules/any_json_rule.ts

@@ -0,0 +1,26 @@
+import vine from '@vinejs/vine'
+
+function isValidJsonValue(value: any): boolean {
+  if (value === null) return true
+  if (['string', 'number', 'boolean'].includes(typeof value)) return true
+
+  if (Array.isArray(value)) {
+    return value.every(isValidJsonValue)
+  }
+
+  if (typeof value === 'object' && Object.prototype.toString.call(value) === '[object Object]') {
+    return Object.values(value).every(isValidJsonValue)
+  }
+
+  return false
+}
+
+export const anyJsonRule = vine.createRule((value, _options, field) => {
+  if (value === undefined || value === null) {
+    return
+  }
+
+  if (!isValidJsonValue(value)) {
+    field.report('Not valid JSON in {{ field }}', 'anyJson', field)
+  }
+})

apps/backend/app/validators/schemas/create_file_input_schema.ts

@@ -0,0 +1,23 @@
+import { VineMultipartFile } from '@adonisjs/core/vine'
+import { OptionalModifier } from '@vinejs/vine/schema/base/literal'
+import vine from '@vinejs/vine'
+
+/**
+ * Creates a reusable upload file schema that requires either:
+ * - `ref` (reference to an existing file), or
+ * - `file` (new uploaded file).
+ *
+ * At least one field must be present. When `ref` is missing, `file`
+ * becomes required. When `file` is missing, `ref` becomes required.
+ *
+ * @param fileScheme Custom optional file validation schema.
+ * @returns Vine object schema with mutually dependent `ref` and `file` fields.
+ */
+export default function createFileInputSchema(
+  fileScheme: OptionalModifier<VineMultipartFile> = vine.file({ size: '5mb' }).optional()
+) {
+  return vine.object({
+    ref: vine.string().optional().requiredIfMissing('file'),
+    file: fileScheme.requiredIfMissing('ref'),
+  })
+}

apps/backend/app/validators/schemas/json_object_schema.ts

@@ -0,0 +1,13 @@
+import vine from '@vinejs/vine'
+
+export type JsonValue =
+  | string
+  | number
+  | boolean
+  | null
+  | JsonValue[]
+  | { [key: string]: JsonValue }
+
+export type JsonObject = Record<string, JsonValue>
+
+export const jsonObjectSchema = vine.object({}).allowUnknownProperties<JsonValue>()