Initial Commits

Author: schorpy

.gitignore

@@ -0,0 +1,5 @@
+/vendor
+composer.lock
+/phpunit.xml
+.phpunit.result.cache
+.idea

README.md

@@ -0,0 +1,117 @@
+# Laravel TriggerDev Package
+
+A Laravel package to integrate **Trigger.Dev** APIs into your Laravel application, inspired by Laravel Cashier. 
+It allows you to manage **Tasks, Runs, Schedules, and Environment Variables (EnvVars)** easily from your Laravel app.
+
+---
+
+## Features
+
+- **Task Trigger**: Trigger individual tasks or batch tasks.
+- **Runs**: List, retrieve, replay, cancel, reschedule, and update metadata for runs.
+- **Schedules**: Create, update, activate, deactivate, and delete schedules.
+- **EnvVars**: List, create, upload, update, retrieve, and delete environment variables.
+
+---
+
+# Usage
+### Task Trigger
+
+```php
+use Schorpy\TriggerDev\Task;
+
+// Trigger a single task
+$response = Task::trigger('hello-world', ['foo' => 'bar'], ['priority' => 1]);
+
+// Trigger a task with a public token
+$response = Task::triggerWithPublicToken(
+ taskId: 'hello-world',
+ payload: ['foo' => 'bar'],
+ options: ['priority' => 1],
+ ttl: '1h'
+);
+
+// Batch trigger multiple tasks
+$batchResponse = Task::batchTrigger([
+ ['task' => 'task-1', 'payload' => ['a' => 1]],
+ ['task' => 'task-2', 'payload' => ['b' => 2]],
+]);
+```
+### Runs
+
+```php
+use Schorpy\TriggerDev\Runs;
+
+// List all runs
+$runs = Runs::list();
+
+// Retrieve a single run
+$run = Runs::retrieve('run_1234');
+
+// Replay or cancel a run
+$replayed = Runs::replay('run_1234');
+$canceled = Runs::cancel('run_1234');
+
+// Reschedule a run
+$rescheduled = Runs::reschedule('run_1234', '2025-09-16T10:00:00Z');
+
+// Update metadata
+$metadataUpdated = Runs::metadata('run_1234', [
+ 'key' => 'value',
+ 'env' => 'production'
+]);
+```
+### Schedules
+```php
+use Schorpy\TriggerDev\Schedules;
+
+// List schedules
+$schedules = Schedules::list();
+
+// Create a schedule
+$newSchedule = Schedules::create('my-task', '0 0 * * *', 'external-id', 'America/New_York');
+
+// Retrieve, update, or delete a schedule
+$schedule = Schedules::retrieve('sch_1234');
+$updated = Schedules::update('sch_1234', 'my-updated-task', '0 0 * * *', 'external-id', 'America/New_York');
+Schedules::delete('sch_1234');
+
+// Activate or deactivate a schedule
+Schedules::activate('sch_1234');
+Schedules::deactivate('sch_1234');
+```
+### EnvVars
+
+```php
+use Schorpy\TriggerDev\EnvVars;
+
+$project = 'proj_yubjwjsfkxnylobaqvqz';
+$env = 'dev';
+
+// List environment variables
+$vars = EnvVars::list($project, $env);
+
+// Upload multiple variables
+EnvVars::upload($project, $env, [
+ ['name' => 'SLACK_API_KEY', 'value' => 'slack_123456'],
+ ['name' => 'API_SECRET', 'value' => 'secret_789']
+], false);
+
+// Create a single variable
+EnvVars::create($project, $env, 'SLACK_API_KEY', 'slack_123456');
+
+// Retrieve, update, or delete a variable
+$var = EnvVars::retrieve($project, $env, 'SLACK_API_KEY');
+EnvVars::update($project, $env, 'SLACK_API_KEY', 'slack_new_987');
+EnvVars::delete($project, $env, 'SLACK_API_KEY');
+```
+
+### Contributing
+
+We welcome contributions! Here's how to help:
+
+- Fork the repository to your GitHub account and clone it locally.
+- Create a feature branch for your changes.
+- Implement changes or add features.
+- Test thoroughly to ensure functionality.
+- Submit a pull request with a detailed description of your changes.

composer.json

@@ -0,0 +1,37 @@
+{
+ "name": "schorpy/triggerdev-laravel",
+ "description": "Laravel package for trigger.dev",
+ "keywords": [
+ "laravel",
+ "triggerdev",
+ "php",
+ "saas"
+ ],
+ "version": "1.0.0",
+ "license": "MIT",
+ "require": {
+ "php": "~8.2.0|~8.3.0|~8.4.0",
+ "guzzlehttp/guzzle": "^7.0",
+ "firebase/php-jwt": "^6.11",
+ "laravel/framework": "^11.0|^12.0"
+ },
+ "autoload": {
+ "psr-4": {
+ "Schorpy\\TriggerDev\\": "src/"
+ }
+ },
+ "extra": {
+ "laravel": {
+ "providers": [
+ "Schorpy\\TriggerDev\\TriggerServiceProvider"
+ ]
+ }
+ },
+ "authors": [
+ {
+ "name": "schorpy",
+ "email": "87610109+schorpy@users.noreply.github.com"
+ }
+ ],
+ "minimum-stability": "stable"
+}

config/triggerdev.php

@@ -0,0 +1,31 @@
+<?php
+
+return [
+
+
+ /*
+ |--------------------------------------------------------------------------
+ | TriggerDev Secret Key
+ |--------------------------------------------------------------------------
+ |
+ | The TriggerDev Secret Key is used to call API from TriggerDev.
+ | You can find your TriggerDev Secret Key in the TriggerDev dashboard.
+ |
+ */
+
+ 'secret_key' => env('TRIGGERDEV_SECRET_KEY'),
+
+ /*
+ |--------------------------------------------------------------------------
+ | TriggerDev Url Path
+ |--------------------------------------------------------------------------
+ |
+ | This is the base URI where routes from TriggerDev will be served
+ | from. The URL built into TriggerDev is used by default; however,
+ | you can modify this path as you see fit for your application.
+ |
+ */
+
+ 'path' => env('TRIGGERDEV_PATH', 'triggerdev'),
+
+];

database/migrations/2025_09_14_000001_create_jobs_table.php

@@ -0,0 +1,50 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+ /**
+ * Run the migrations.
+ */
+ public function up(): void
+ {
+ Schema::create('trigger_jobs', function (Blueprint $table) {
+ $table->id();
+
+ // Unique identifier for the trigger job
+ $table->uuid('uuid')->unique();
+
+ // Polymorphic relation to billable model (user/account/etc.)
+ $table->string('billable_type');
+ $table->unsignedBigInteger('billable_id');
+
+
+ // Status of the job/event
+ $table->enum('status', ['pending', 'running', 'completed', 'failed'])
+ ->default('pending');
+
+ // External Trigger.dev / Inngest job ID
+ $table->string('run_id')->unique();
+
+ // Optional: store arbitrary job data
+ $table->json('payload')->nullable();
+
+ $table->timestamps();
+
+ // Indexes for fast lookups
+ $table->index(['billable_type', 'billable_id']);
+ $table->index('status');
+ });
+ }
+
+ /**
+ * Reverse the migrations.
+ */
+ public function down(): void
+ {
+ Schema::dropIfExists('trigger_jobs');
+ }
+};

routes/web.php

@@ -0,0 +1,5 @@
+<?php
+
+use Illuminate\Support\Facades\Route;
+
+Route::post('webhook', 'WebhookController')->name('webhook');

src/EnvVars.php

@@ -0,0 +1,45 @@
+<?php
+
+namespace Schorpy\TriggerDev;
+
+
+class EnvVars
+{
+ public static function list(string $projectRef, string $env): array
+ {
+ return TriggerDev::api('get', "projects/{$projectRef}/envvars/{$env}")->json();
+ }
+
+ public static function upload(string $projectRef, string $env, array $variables, bool $override = false): array
+ {
+ return TriggerDev::api('post', "projects/{$projectRef}/envvars/{$env}/import", [
+ 'variables' => $variables, // e.g. [ ['name' => 'SLACK_API_KEY', 'value' => 'slack_123'] ]
+ 'override' => $override,
+ ])->json();
+ }
+
+ public static function create(string $projectRef, string $env, string $name, string $value): array
+ {
+ return TriggerDev::api('post', "projects/{$projectRef}/envvars/{$env}", [
+ 'name' => $name,
+ 'value' => $value,
+ ])->json();
+ }
+
+ public static function retrieve(string $projectRef, string $env, string $name): array
+ {
+ return TriggerDev::api('get', "projects/{$projectRef}/envvars/{$env}/{$name}")->json();
+ }
+
+ public static function update(string $projectRef, string $env, string $name, string $value): array
+ {
+ return TriggerDev::api('put', "projects/{$projectRef}/envvars/{$env}/{$name}", [
+ 'value' => $value,
+ ])->json();
+ }
+
+ public static function delete(string $projectRef, string $env, string $name): array
+ {
+ return TriggerDev::api('delete', "projects/{$projectRef}/envvars/{$env}/{$name}")->json();
+ }
+}

src/Events/WebhookHandled.php

@@ -0,0 +1,19 @@
+<?php
+
+namespace Schorpy\TriggerDev\Events;
+
+use Illuminate\Foundation\Events\Dispatchable;
+use Illuminate\Queue\SerializesModels;
+
+class WebhookHandled
+{
+ use Dispatchable;
+ use SerializesModels;
+
+ public array $payload;
+
+ public function __construct(array $payload)
+ {
+ $this->payload = $payload;
+ }
+}

src/Events/WebhookReceived.php

@@ -0,0 +1,28 @@
+<?php
+
+namespace Schorpy\TriggerDev\Events;
+
+use Illuminate\Foundation\Events\Dispatchable;
+use Illuminate\Queue\SerializesModels;
+
+class WebhookReceived
+{
+ use Dispatchable;
+ use SerializesModels;
+
+ /**
+ * @var array
+ */
+ public $payload;
+
+ /**
+ * Create a new event instance.
+ *
+ * @param array $payload
+ * @return void
+ */
+ public function __construct(array $payload)
+ {
+ $this->payload = $payload;
+ }
+}