Laravel Rewind Laravel Package

New Features

• Batch versioning -- Rewind::batch(fn) groups multiple model changes under a shared batch_uuid. Query with RewindVersion::inBatch($uuid).
• Non-destructive restore -- Rewind::restore($model, $version) creates a new version from a previous version's state. Tracks VersionEventType::Restored and stores restored_from_version in meta.
• Custom version model -- Set version_model in config to extend RewindVersion with custom columns, scopes, or accessors.

Migration

New batch_uuid column on the versions table. Publish and run:

php artisan vendor:publish --tag=laravel-rewind-migrations
php artisan migrate

New Config Keys

// Custom version model (must extend RewindVersion)
'version_model' => null,

Closes #54, #55, #56.

New Features

• Version diff/comparison API -- Compare any two versions with Rewind::diff($model, $from, $to), returns a structured VersionDiff DTO with changed, added, and removed attributes.
• Custom metadata per version -- Attach arbitrary key-value data to versions via Rewind::withMeta(['reason' => '...']). Stored in a new meta JSON column. Metadata is automatically cleared after version creation.
• Event type tracking -- Each version now records its event_type (created, updated, or deleted) in a dedicated column, making version history queryable by action type.
• Query scopes on RewindVersion -- New scopes: forModel(), byUser(), ofType(), betweenDates(), betweenVersions() for filtering version records.
• Version pruning system -- New rewind:prune command with --keep, --days, --model, --pretend, and --force options. Automatically converts the new oldest version to a snapshot to preserve navigability.
• Auto-pruning -- Per-model $maxRewindVersions property and global max_versions config. Pruning is batched using snapshot_interval as a buffer to amortize transaction costs.
• Configurable lock timeout handling -- New on_lock_timeout config with log, event, and throw modes. New RewindVersionLockTimeout event and LockTimeoutRewindException.
• Composite database index -- (model_type, model_id, version) for faster version-scoped queries.

Bug Fixes

• Fix soft delete version timestamp mismatch -- moved version creation to deleted event to capture exact database timestamp.
• Fix queued listener serialization -- capture changes and wasRecentlyCreated at dispatch time so they survive SerializesModels round-trips.
• Fix version pruning with gaps -- iterate actual version records instead of sequential integers.
• Add transaction safety -- version creation, current_version update, and auto-prune are now atomic.
• Add cache lock to goTo() for concurrency safety.
• Use saveQuietly() when updating current_version to prevent unintended model events.

Architecture

• New StateBuilder service consolidating all state reconstruction logic.
• New RewindManagerInterface contract for dependency injection.
• New VersionPruner service, PruneResult DTO, RewindContext singleton, SchemaHelper utility.
• ApproachEngine now accepts Collection for use outside of model context.
• Internal classes marked with [@internal](https://github.com/internal) to define public API boundary.

Housekeeping

• Removed version field from composer.json (Packagist reads git tags).
• Changed minimum-stability from dev to stable.
• Added CONTRIBUTING.md.

New Config Options

Re-publish the config file to get all new options, or add them manually:

php artisan vendor:publish --tag="laravel-rewind-config" --force

Migration Notes

This release adds two new nullable columns to the rewind_versions table: event_type (string) and meta (json).

New installations get these columns automatically via the existing migration.

Existing installations should publish and run the new upgrade migration:

php artisan vendor:publish --tag="laravel-rewind-migrations"
php artisan migrate

The upgrade migration is idempotent — it checks for existing columns before adding them, so it's safe to run even if you've already added the columns manually.

Full Changelog: https://github.com/avocet-shores/laravel-rewind/compare/v0.7.4...v0.8.0

What's Changed

• Fix getDirty() vs getChanges() bug in saved event by @jared-cannon in https://github.com/avocet-shores/laravel-rewind/pull/36
• Fix Rewindable trait firing model observers twice by @jared-cannon in https://github.com/avocet-shores/laravel-rewind/pull/38
• Bump version to 0.7.4 by @jared-cannon in https://github.com/avocet-shores/laravel-rewind/pull/39

Full Changelog: https://github.com/avocet-shores/laravel-rewind/compare/v0.7.3...v0.7.4

What's Changed

• Bump dependabot/fetch-metadata from 2.3.0 to 2.4.0 by @dependabot[bot] in https://github.com/avocet-shores/laravel-rewind/pull/27
• Bump aglipanci/laravel-pint-action from 2.5 to 2.6 by @dependabot[bot] in https://github.com/avocet-shores/laravel-rewind/pull/29
• Update PHP version requirement to include 8.4 by @danielrona in https://github.com/avocet-shores/laravel-rewind/pull/31
• Fix excluded attributes not working with SoftDeletes models by @jared-cannon in https://github.com/avocet-shores/laravel-rewind/pull/33
• Bump version to 0.7.3 by @jared-cannon in https://github.com/avocet-shores/laravel-rewind/pull/34

New Contributors

• @danielrona made their first contribution in https://github.com/avocet-shores/laravel-rewind/pull/31

Full Changelog: https://github.com/avocet-shores/laravel-rewind/compare/v0.7.2...v0.7.3

What's Changed

• Append version 12.0 to the package ‘illuminate/contracts’. by @fdjkgh580 in https://github.com/avocet-shores/laravel-rewind/pull/23

New Contributors

• @fdjkgh580 made their first contribution in https://github.com/avocet-shores/laravel-rewind/pull/23

Full Changelog: https://github.com/avocet-shores/laravel-rewind/compare/v0.7.1...v0.7.2

What's Changed

Bug Fixes and Improvements

• Fix Delete Bug and Add Soft Delete Tracking by @jared-cannon in https://github.com/avocet-shores/laravel-rewind/pull/20

Docs

• docs: Fix Rewindable trait on model by @nilshee in https://github.com/avocet-shores/laravel-rewind/pull/19

New Contributors

• @nilshee made their first contribution in https://github.com/avocet-shores/laravel-rewind/pull/19

Full Changelog: https://github.com/avocet-shores/laravel-rewind/compare/v0.7.0...v0.7.1

What's Changed

• Update Morph Relationship by @jared-cannon in https://github.com/avocet-shores/laravel-rewind/pull/12
• Concurrency config enhancements and current_version column requirements by @jared-cannon in https://github.com/avocet-shores/laravel-rewind/pull/9

Full Changelog: https://github.com/avocet-shores/laravel-rewind/compare/v0.6.0...v0.7.0

New Features

• State transition tracking -- Designate fields as state fields via $rewindStateFields on your model. Rewind records structured from/to transitions alongside each version. Query with whereStateBecame(), whereStateWas(), whereStateChanged(), and whereStateTransition() scopes, or get a full timeline with $model->stateHistory($field).

Migration

New state_transitions column on the versions table. Publish and run:

php artisan vendor:publish --provider="AvocetShores\LaravelRewind\LaravelRewindServiceProvider"
php artisan migrate