Release/v0.3.0

CHANGELOG.md

@@ -7,6 +7,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [[v0.3.0](https://github.com/The-FireHub-Project/Runtime/compare/v0.2.6...v0.3.0)] – 2026-09-16
+
+### Added
+* Add PHP Hash utility wrappers and supporting exceptions by @dieselxxx
+
 ## [[v0.2.6](https://github.com/The-FireHub-Project/Runtime/compare/v0.2.5...v0.2.6)] – 2026-09-11
 
 ### Changed

src/Exception/EmptyHashKeyException.php

@@ -0,0 +1,31 @@
+<?php declare(strict_types = 1);
+
+/**
+ * This file is part of the FireHub Project ecosystem
+ *
+ * @author Danijel Galić <danijel.galic@outlook.com>
+ * @copyright 2026-present The FireHub Project - All rights reserved
+ * @license https://opensource.org/license/Apache-2-0 Apache License, Version 2.0
+ *
+ * @php-version >=8.3
+ * @package Runtime
+ */
+
+namespace FireHub\Runtime\Exception;
+
+use FireHub\Core\Exception\Runtime\InvalidArgumentException;
+
+/**
+ * ### Represents an empty hash key provided to an operation that requires a non-empty hash key
+ * @since 1.0.0
+ */
+final class EmptyHashKeyException extends InvalidArgumentException {
+
+    /**
+     * @inheritDoc
+     *
+     * @since 1.0.0
+     */
+    protected const string DEFAULT_MESSAGE = 'The provided hash key is empty.';
+
+}

src/Exception/HashByteLengthException.php

@@ -0,0 +1,31 @@
+<?php declare(strict_types = 1);
+
+/**
+ * This file is part of the FireHub Project ecosystem
+ *
+ * @author Danijel Galić <danijel.galic@outlook.com>
+ * @copyright 2026-present The FireHub Project - All rights reserved
+ * @license https://opensource.org/license/Apache-2-0 Apache License, Version 2.0
+ *
+ * @php-version >=8.3
+ * @package Runtime
+ */
+
+namespace FireHub\Runtime\Exception;
+
+use FireHub\Core\Exception\Runtime\InvalidArgumentException;
+
+/**
+ * ### Represents an invalid hash byte length provided to an operation that requires a valid hash byte length
+ * @since 1.0.0
+ */
+final class HashByteLengthException extends InvalidArgumentException {
+
+    /**
+     * @inheritDoc
+     *
+     * @since 1.0.0
+     */
+    protected const string DEFAULT_MESSAGE = 'The provided hash byte length is invalid.';
+
+}

src/Exception/HashIterationException.php

@@ -0,0 +1,31 @@
+<?php declare(strict_types = 1);
+
+/**
+ * This file is part of the FireHub Project ecosystem
+ *
+ * @author Danijel Galić <danijel.galic@outlook.com>
+ * @copyright 2026-present The FireHub Project - All rights reserved
+ * @license https://opensource.org/license/Apache-2-0 Apache License, Version 2.0
+ *
+ * @php-version >=8.3
+ * @package Runtime
+ */
+
+namespace FireHub\Runtime\Exception;
+
+use FireHub\Core\Exception\Runtime\InvalidArgumentException;
+
+/**
+ * ### Represents an invalid hash iteration provided to an operation that requires a valid hash iteration
+ * @since 1.0.0
+ */
+final class HashIterationException extends InvalidArgumentException {
+
+    /**
+     * @inheritDoc
+     *
+     * @since 1.0.0
+     */
+    protected const string DEFAULT_MESSAGE = 'The provided hash iteration is invalid.';
+
+}