fixup! feat(database): introduce Snowflake IDs generator

Signed-off-by: Benjamin Gaussorgues <[email protected]>

Author: Altahrim

lib/private/Snowflake/Generator.php

@@ -35,7 +35,7 @@ public function nextId(): string {
 		$serverId = $this->getServerId() & 0x1FF; // Keep 9 bits
 		$isCli = (int)$this->isCli(); // 1 bit
 		$sequenceId = $this->getSequenceId($seconds, $milliseconds, $serverId); //  12 bits
-		if ($sequenceId > 0xFFF) {
+		if ($sequenceId > 0xFFF || $sequenceId === false) {
 			// Throttle a bit, wait for next millisecond
 			usleep(1000);
 			return $this->nextId();
@@ -109,6 +109,12 @@ private function isCli(): bool {
 		return PHP_SAPI === 'cli';
 	}
 
+	/**
+	 * Generates sequence ID from APCu (general case) or random if APCu disabled or CLI
+	 *
+	 * @return int|false Sequence ID or false if APCu not ready
+	 * @throws \Exception if there is an error with APCu
+	 */
 	private function getSequenceId(int $seconds, int $milliseconds, int $serverId): int|false {
 		$key = 'seq:' . $seconds . ':' . $milliseconds;