Repository: brefphp/bref (language: php)

Issue:
Review and update all `@internal` tags
I noticed that plenty of `@internal` (and even `@experimental`) tags might be removed for v2. The goal of this issue is to review all of them.


Discussion / hints:

Fix patch:
diff --git a/src/Bref.php b/src/Bref.php
index 5a1959dc8..1d1d9e0f6 100644
--- a/src/Bref.php
+++ b/src/Bref.php
@@ -23,7 +23,7 @@ public static function setContainer(Closure $containerProvider): void
     }
 
     /**
-     * @internal
+     * @internal Used by the Bref runtime
      */
     public static function getContainer(): ContainerInterface
     {
diff --git a/src/Context/ContextBuilder.php b/src/Context/ContextBuilder.php
index 653b84956..e75f3da23 100644
--- a/src/Context/ContextBuilder.php
+++ b/src/Context/ContextBuilder.php
@@ -2,9 +2,6 @@
 
 namespace Bref\Context;
 
-/**
- * @internal
- */
 final class ContextBuilder
 {
     private string $awsRequestId;
diff --git a/src/Event/Http/Psr7Bridge.php b/src/Event/Http/Psr7Bridge.php
index 985c0f8ab..f6503951e 100644
--- a/src/Event/Http/Psr7Bridge.php
+++ b/src/Event/Http/Psr7Bridge.php
@@ -15,8 +15,6 @@
 
 /**
  * Bridges PSR-7 requests and responses with API Gateway or ALB event/response formats.
- *
- * @internal
  */
 final class Psr7Bridge
 {
diff --git a/src/Event/S3/Bucket.php b/src/Event/S3/Bucket.php
index b4f489419..abf6fc965 100644
--- a/src/Event/S3/Bucket.php
+++ b/src/Event/S3/Bucket.php
@@ -10,9 +10,6 @@ final class Bucket
     private string $name;
     private string $arn;
 
-    /**
-     * @internal
-     */
     public function __construct(string $name, string $arn)
     {
         $this->name = $name;
diff --git a/src/Event/S3/BucketObject.php b/src/Event/S3/BucketObject.php
index ca4cedb38..24a62b052 100644
--- a/src/Event/S3/BucketObject.php
+++ b/src/Event/S3/BucketObject.php
@@ -11,9 +11,6 @@ final class BucketObject
     private int $size;
     private ?string $versionId;
 
-    /**
-     * @internal
-     */
     public function __construct(string $key, int $size, ?string $versionId = null)
     {
         $this->key = $key;
diff --git a/src/Event/S3/S3Event.php b/src/Event/S3/S3Event.php
index 0be35bee5..6496639a6 100644
--- a/src/Event/S3/S3Event.php
+++ b/src/Event/S3/S3Event.php
@@ -15,9 +15,6 @@ final class S3Event implements LambdaEvent
 {
     private array $event;
 
-    /**
-     * @internal
-     */
     public function __construct(mixed $event)
     {
         if (! is_array($event) || ! isset($event['Records'])) {
diff --git a/src/Event/S3/S3Record.php b/src/Event/S3/S3Record.php
index f4b0e9c2d..e748abd36 100644
--- a/src/Event/S3/S3Record.php
+++ b/src/Event/S3/S3Record.php
@@ -12,9 +12,6 @@ final class S3Record
 {
     private array $record;
 
-    /**
-     * @internal
-     */
     public function __construct(mixed $record)
     {
         if (! is_array($record) || ! isset($record['eventSource']) || $record['eventSource'] !== 'aws:s3') {
diff --git a/src/Runtime/FileHandlerLocator.php b/src/Runtime/FileHandlerLocator.php
index ef2dd72df..43f4435cf 100644
--- a/src/Runtime/FileHandlerLocator.php
+++ b/src/Runtime/FileHandlerLocator.php
@@ -11,7 +11,6 @@
  * Whenever a Lambda function executes, this class will `require` that PHP file
  * and return what the file returns.
  *
- * @internal
  * @see \Bref\Bref::setContainer()
  */
 class FileHandlerLocator implements ContainerInterface


Test patch: