Initial Version

core/lib/Db/ObjectId.php

@@ -0,0 +1,71 @@
+<?php
+
+namespace KTXC\Db;
+
+use MongoDB\BSON\ObjectId as MongoObjectId;
+
+/**
+ * Wrapper for MongoDB\BSON\ObjectId
+ * Provides abstraction layer for MongoDB ObjectId handling
+ */
+class ObjectId
+{
+    private MongoObjectId $objectId;
+
+    /**
+     * Create a new ObjectId
+     * 
+     * @param string|MongoObjectId|null $id Optional ID string or MongoDB ObjectId
+     */
+    public function __construct(string|MongoObjectId|null $id = null)
+    {
+        if ($id instanceof MongoObjectId) {
+            $this->objectId = $id;
+        } elseif (is_string($id)) {
+            $this->objectId = new MongoObjectId($id);
+        } else {
+            $this->objectId = new MongoObjectId();
+        }
+    }
+
+    /**
+     * Get the string representation of the ObjectId
+     */
+    public function __toString(): string
+    {
+        return (string) $this->objectId;
+    }
+
+    /**
+     * Get the underlying MongoDB ObjectId
+     * Used internally when interacting with MongoDB driver
+     */
+    public function toBSON(): MongoObjectId
+    {
+        return $this->objectId;
+    }
+
+    /**
+     * Get the timestamp from the ObjectId
+     */
+    public function getTimestamp(): int
+    {
+        return $this->objectId->getTimestamp();
+    }
+
+    /**
+     * Create ObjectId from string
+     */
+    public static function fromString(string $id): self
+    {
+        return new self($id);
+    }
+
+    /**
+     * Check if a string is a valid ObjectId
+     */
+    public static function isValid(string $id): bool
+    {
+        return MongoObjectId::isValid($id);
+    }
+}