Merge pull request #653 from wayofdev/feat/laravel-telescope

Author: lotyp

docs/pages/services/laravel-telescope.mdx

@@ -21,17 +21,43 @@ Install, telescope as usual, via Composer package manager:
 composer require laravel/telescope
 ```
 
-### Step 2: Publish Telescope Assets and run Migrations
+### Step 2: Publish Telescope Assets
 
-After installing Telescope, publish its assets and migrations using the telescope:install Artisan command. After installing Telescope, you should also run the migrate command in order to create the tables needed to store Telescope's data:
+After installing Telescope, publish its assets and migrations using the `telescope:install` Artisan command.
 
 ```bash
 php artisan telescope:install
+```
+
+### Step 3: Run Telescope Migrations trough Cycle-ORM-Adapter
+
+After installing Telescope, you should also run the migrate command in order to create the tables needed to store Telescope's data, but as you are using Cycle ORM, you should avoid using default `php artisan migrate` command, and instead, do the following steps:
+
+Edit `config/cycle.php` file and add the following code to the `tokenizer.directories` array:
 
-php artisan migrate
+```php {7} filename="config/cycle.php"
+return [
+    // ...
+    'tokenizer' => [
+    // ...
+        'directories' => [
+            app_path(),
+            __DIR__ . '/../vendor/wayofdev/laravel-cycle-orm-adapter/src/Bridge/Telescope/Entities',
+        ],
+    ],
+],
 ```
 
-### Step 3: Add the CycleORM Query Watcher
+Run the following command to create the Telescope tables:
+
+```bash
+php artisan cycle:migrate:init
+
+php artisan cycle:orm:migrate --split --run
+```
+
+
+### Step 4: Add the CycleORM Query Watcher
 
 Next, edit your `config/telescope.php` configuration file and add the following lines to the `watchers` array, right after the default`Watchers\QueryWatcher::class` line:
 
@@ -59,7 +85,7 @@ return [
 ];
 ```
 
-### Step 4: Add .env Configuration
+### Step 5: Add .env Configuration
 
 Add the following configuration to your `.env` file:
 
@@ -71,7 +97,7 @@ DB_USE_TELESCOPE_LOGGER=true
 ...
 ```
 
-### Step 5: Access Laravel Telescope
+### Step 6: Access Laravel Telescope
 
 Finally, you may access the Telescope dashboard via the `/telescope` route. Of course, don't forget to start your Laravel application:
 

src/Bridge/Telescope/Entities/TelescopeEntry.php

@@ -9,17 +9,18 @@
 use Cycle\Annotated\Annotation\Table\Index;
 use DateTimeImmutable;
 
-#[Index(columns: ['batch_id'])]
-#[Index(columns: ['family_hash'])]
-#[Index(columns: ['created_at'])]
-#[Index(columns: ['type', 'should_display_on_index'])]
+#[Index(columns: ['uuid'], unique: true, name: 'telescope_entries_uuid_unique')]
+#[Index(columns: ['batch_id'], name: 'telescope_entries_batch_id_index')]
+#[Index(columns: ['family_hash'], name: 'telescope_entries_family_hash_index')]
+#[Index(columns: ['created_at'], name: 'telescope_entries_created_at_index')]
+#[Index(columns: ['type', 'should_display_on_index'], name: 'telescope_entries_type_should_display_on_index_index')]
 #[Entity(table: 'telescope_entries')]
 class TelescopeEntry
 {
-    #[Column(type: 'bigInteger', primary: true)]
+    #[Column(type: 'primary')]
     public int $sequence;
 
-    #[Column(type: 'uuid', unique: true)]
+    #[Column(type: 'uuid')]
     public string $uuid;
 
     #[Column(type: 'uuid')]

src/Bridge/Telescope/Entities/TelescopeEntryTags.php renamed to src/Bridge/Telescope/Entities/TelescopeEntryTag.php

@@ -9,13 +9,16 @@
 use Cycle\Annotated\Annotation\ForeignKey;
 use Cycle\Annotated\Annotation\Table\Index;
 
-#[Index(columns: ['entry_uuid', 'tag'])]
+#[Index(columns: ['entry_uuid', 'tag'], unique: true)]
 #[Index(columns: ['tag'])]
 #[ForeignKey(target: TelescopeEntry::class, innerKey: 'entry_uuid', outerKey: 'uuid', action: 'CASCADE')]
-#[Entity(table: 'telescope_entry_tags')]
-class TelescopeEntryTags
+#[Entity(table: 'telescope_entries_tags')]
+class TelescopeEntryTag
 {
-    #[Column(type: 'uuid', primary: true)]
+    #[Column(type: 'primary')]
+    public int $id;
+
+    #[Column(type: 'uuid')]
     public string $entryUuid;
 
     #[Column(type: 'string')]