Download the PHP package jeffersongoncalves/filament-satis without Composer

Filament Satis

A Filament plugin for managing private Composer repositories powered by Satis.

Features

• Package Management — Add and manage Composer & GitHub package sources with CRUD operations
• Token-Based Auth — Secure access with per-token package scoping
• Dev Packages — Mark packages as development-only with is_dev flag
• Version Tracking — Automatic tracking of package releases synced from Satis builds
• Download Statistics — Per-version download tracking and analytics
• Dependency Mapping — Public/private dependency classification from package releases
• Multi-Tenancy — Tenant-isolated data with configurable foreign keys
• Credential Validation — Verify package accessibility with tracked validation timestamps
• Intelligent Validation — Timestamp-based comparison to skip unnecessary rebuilds
• Auth.json Support — Automatic auth.json generation for authenticated Composer builds
• Credential Sanitization — Remove transport-options from Satis JSON files to prevent credential leaks
• GitHub Webhooks — Auto-rebuild on push, release and create events with HMAC-SHA256 signature validation
• Per-Resource Config — Customize navigation, icons, slugs, clusters, and visibility per resource
• Global Search — Search packages, tokens, releases, and dependencies from the global search bar
• Bilingual — English and Brazilian Portuguese translations included
• Laravel Boost — AI guidelines and skills for assisted development

Version Compatibility

Requirements

• PHP ^8.3
• Laravel ^11.28
• Filament ^5.0
• jeffersongoncalves/laravel-satis ^1.0

Installation

You can install the package via composer:

1. Require the packages

This will automatically install jeffersongoncalves/laravel-satis as a dependency.

2. Publish and run migrations

3. Publish the config (optional)

Quick Start

1. Register the plugin

Add the plugin to your Filament panel provider:

2. Create packages and tokens

1. Navigate to Satis > Packages in the admin panel
2. Add a package with its repository URL
3. Navigate to Satis > Tokens and create an authentication token
4. Associate the token with the packages it should access

3. Build the repository

4. Configure your client

In your client project's composer.json:

Authenticate with the token:

Multi-Tenancy

Enable tenant isolation for packages, tokens, and builds:

The plugin automatically:

• Sets the satis tenancy configuration during register()
• Configures the tenant resolver using filament()->getTenant() during boot()
• Scopes all queries and auto-sets the foreign key on creation

Configuration

Filament Plugin Config

The config/filament-satis.php file provides per-resource customization:

Laravel Satis Config

The config/satis.php file configures the core backend:

Resources

The plugin registers 5 Filament resources:

Relation Managers

• PackageResource includes ReleasesRelationManager and DownloadsRelationManager
• DependencyResource includes PackageReleasesRelationManager

Customization Examples

Hide a resource from navigation

Change navigation icons

Group resources in a cluster

Change the navigation group

Override model classes

Custom models must extend the base models from the package.

Translations

The plugin includes English and Brazilian Portuguese translations.

Publish translations

Translation files use the filament-satis:: namespace:

Commands

GitHub Webhooks

Each package auto-generates a webhook_secret and reference. Configure your GitHub webhook:

• URL: https://your-app.com/api/satis/webhooks/github/{reference}
• Secret: The webhook_secret from the package edit form
• Events: Push, Release, Create
• Content Type: application/json

The webhook handler:

1. Validates the package is a GitHub type
2. Filters supported events (push, release, create)
3. Verifies HMAC-SHA256 signature when a secret is configured
4. Dispatches tenant and token rebuilds

Laravel Boost Integration

This package includes Laravel Boost guidelines and skills for AI-assisted development. When Boost is installed in your project, run:

The plugin's AI guidelines and skills will be automatically detected and available to your coding agent.

Testing

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

Credits

• Jefferson Goncalves
• All Contributors

License

The MIT License (MIT). Please see License File for more information.