feat: add static helper class for license constants (#15)

This PR adds a new class for holding license constants, which is read by extensions like LibreJS to check that the site contains free JavaScript code.

Reviewed-on: https://codeberg.org/vlw/scaffold/pulls/15

src/Database/Controller.php

@@ -0,0 +1,115 @@
+<?php
+
+	namespace vlw\Scaffold\Database;
+
+	use ReflectionClass;
+	use ReflectionProperty;
+	use ReflectionNamedType;
+	use ReflectionUnionType;
+
+	/**
+	 * Modify database entity values using an instanced database Model
+	 */
+	class Controller {
+		/**
+		 * Returns an array of allowed property types
+		 *
+		 * @param ReflectionNamedType|ReflectionUnionType A \ReflectionType instance to retrieve types from
+		 * @return array<string> An array containing the allowed property types (literals and classes)
+		 */
+		private static function get_types(ReflectionNamedType|ReflectionUnionType $type): array {
+			$types = [];
+
+			// Property value is nullable
+			if ($type->allowsNull()) {
+				$types[] = "null";
+			}
+
+			// Property only accepts one type
+			if ($type instanceof ReflectionNamedType) {
+				// Add type name to output and trim shorthand nullable from name if present
+				$types[] = ltrim($type->getName(), "?");
+				return $types;
+			}
+
+			return array_merge($types, $type->getTypes());
+		}
+
+		/**
+		 * Creates a new instance of a class-like object
+		 *
+		 * @param string Namespaced class name to instance
+		 * @param array<mixed> Arguments to pass to the class constructor
+		 * @return object Instanced class
+		 */
+		private static function instance_class(string $class_name, array $args): object {
+			$class = new ReflectionClass($class_name);
+
+			// Return new instance of Enum from case name
+			if ($class->isEnum()) {
+				return $class_name::fromName(...$args);
+			}
+
+			return $class->newInstance(...$args);
+		}
+
+		/**
+		 * Instance a new Controller for a given database Model
+		 *
+		 * @param Model An instance of a database Model entity
+		 */
+		public function __construct(private readonly Model $model) {}
+
+		/**
+		 * Update a database entity by passing an assoc array of column => value
+		 *
+		 * @param array<array> Associative array of column keys and column values to update
+		 * @return void
+		 */
+		public function update(array $values): void {
+			foreach($values as $key => $value) {
+				// Bail out if we're trying to update a column that has not been implemented
+				// by the passed database Model
+				if (!in_array($key, $this->model->columns)) {
+					continue;
+				}
+
+				$property = new ReflectionProperty($this->model, $key);
+				$types = self::get_types($property->getSettableType());
+
+				// Value is definitely a primitive
+				if (!is_string($value)) {
+					// Property does not accept this primitive as value, bail out
+					if (!in_array(gettype($value), $types)) {
+						continue;
+					}
+
+					// Set primitve value and move on
+					$this->model->{$key} = $value;
+					continue;
+				}
+
+				// Returns the name of the first class object
+				$class_name = array_find($types, fn(string $type): bool => class_exists($type));
+
+				// No class object found, string value must be literal
+				if (!$class_name) {
+					// Property does not accept string literals as value, bail out
+					if (!in_array("string", $types)) {
+						continue;
+					}
+
+					// Set string literal value and move on
+					$this->model->{$key} = $value;
+					continue;
+				}
+
+				// Wrap single value in an array (as one constructor argument)
+				if (!is_array($value)) {
+					$value = [$value];
+				}
+
+				$this->model->{$key} = self::instance_class($class_name, $value);
+			}
+		}
+	}

src/Database/Model.php

@@ -10,7 +10,8 @@
 	 * Abstract reading, creating, and updating of database entities.
 	 */
 	abstract class Model {
-		const DATE_FORMAT = Database::DATE_FORMAT;
+		public const DATE_FORMAT     = Database::DATE_FORMAT;
+		public const DATETIME_FORMAT = Database::DATETIME_FORMAT;
 
 		abstract public string $id { get; }
 
@@ -36,9 +37,9 @@
 		 * @param array<array> $where vlw/MySQL->where() to locate the target entity
 		 */
 		public function __construct(
-			private readonly string $table,
+			public readonly string $table,
-			private readonly array $columns,
+			public readonly array $columns,
-			private readonly array $where
+			public readonly array $where
 		) {
 			$this->db = new Database();
 		}

src/Helpers/License.php

@@ -0,0 +1,34 @@
+<?php
+
+	namespace vlw\Scaffold\Helpers;
+
+	class License {
+		public const MAGNET_END = PHP_EOL . "// @license-end";
+
+		public const GPL_V3_MAGNET = "// @license magnet:?xt=urn:btih:1f739d935676111cfff4b4693e3816e664797050&dn=gpl-3.0.txt GPL-v3-or-Later";
+		public const GPL_V3_BLOCK = "<script><!--//--><![CDATA[//><!--
+			/**
+			 * @licstart The following is the entire license notice for the JavaScript
+			 * code in this page.
+			 *
+			 * Copyright (C) 2020  Free Software Foundation.
+			 *
+			 * The JavaScript code in this page is free software: you can redistribute
+			 * it and/or modify it under the terms of the GNU General Public License
+			 * (GNU GPL) as published by the Free Software Foundation, either version 3
+			 * of the License, or (at your option) any later version.  The code is
+			 * distributed WITHOUT ANY WARRANTY; without even the implied warranty of
+			 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU GPL
+			 * for more details.
+			 *
+			 * As additional permission under GNU GPL version 3 section 7, you may
+			 * distribute non-source (e.g., minimized or compacted) forms of that code
+			 * without the copy of the GNU GPL normally required by section 4, provided
+			 * you include this license notice and a URL through which recipients can
+			 * access the Corresponding Source.
+			 *
+			 * @licend The above is the entire license notice for the JavaScript code
+			 * in this page.
+			 */
+		//--><!]]></script>";
+	}