Integrate `UseMuffin/Footprint` into this plugin?

[LordSimal]

How about we integrate the functionality from https://github.com/UseMuffin/Footprint into this plugin?

[dereuromark]

Here's a rough idea of how this integration could look:

Architecture

Authentication Plugin (extended)
├── Middleware/
│   └── AuthenticationMiddleware.php  # Already exists - would set user in registry
├── Model/
│   └── Behavior/
│       └── FootprintBehavior.php     # New - auto-fills user fields on save
└── UserContextRegistry.php           # New - static/singleton to hold current user

Key Components

1. User Context Registry - Store authenticated user for model layer access:

// src/UserContextRegistry.php
class UserContextRegistry
{
    protected static ?IdentityInterface $identity = null;

    public static function set(?IdentityInterface $identity): void { ... }
    public static function get(): ?IdentityInterface { ... }
}

2. Middleware Enhancement - Set identity in registry after authentication:

// In AuthenticationMiddleware::process()
$identity = $request->getAttribute('identity');
UserContextRegistry::set($identity);

3. FootprintBehavior - Auto-populate user fields:

// src/Model/Behavior/FootprintBehavior.php
class FootprintBehavior extends Behavior
{
    protected array $_defaultConfig = [
        'fields' => [
            'created_by' => 'new',      // Only on insert
            'modified_by' => 'always',  // On insert and update
        ],
        'primaryKey' => 'id',
    ];

    public function beforeSave(EventInterface $event, EntityInterface $entity): void
    {
        $identity = UserContextRegistry::get();
        if (!$identity) {
            return;
        }

        foreach ($this->getConfig('fields') as $field => $when) {
            if ($when === 'new' && !$entity->isNew()) {
                continue;
            }
            if (!$entity->isDirty($field)) {
                $entity->set($field, $identity->get($this->getConfig('primaryKey')));
            }
        }
    }
}

Usage

// In UsersTable
$this->addBehavior('Authentication.Footprint', [
    'fields' => [
        'created_by' => 'new',
        'modified_by' => 'always',
    ],
]);

Considerations

• Static registry vs passing through request - Footprint uses a static approach for simplicity since models don't have request access
• Console/CLI commands - Need a way to set user context manually for scripts
• Testing - Behavior should gracefully handle missing identity
• Middleware order - Must run after AuthenticationMiddleware

This would eliminate the need for a separate plugin and provide tighter integration with the authentication flow.

[markstory]

Is the plugin no longer maintained? If it is still maintained, I think we can provide an adapter for integration with the plugin. Lets try to work with folks in the community before projects are forked/adopted.

[ADmad]

Is the plugin no longer maintained?

The plugin is maintained by me, so maintenance is not an issue.

[dereuromark]

Sounds fair.
Then Footprint already has most of it covered anyway.

CLI / queue / shell contexts - new convenience API

The bit people actually trip on. A tiny helper that mirrors what the middleware does for non-HTTP entry points:

FootprintContext::runAs($identity, function () {
    // commands, queue jobs, seeders…
});

Internally this just dispatches the same event Footprint listens to (or calls Footprint's own context API), so Footprint stays the source of truth for how the user gets attached to saves.