marcglasberg/bloc_superpowers

add-catch-error

Add custom error handling with catchError to a mix() call for logging, error conversion, or suppression

add-check-internet

Add internet connectivity checking before executing a Cubit method with optional retry

add-debounce

Add debounce to delay method execution until after a period of inactivity for search or validation

add-effect-queue

Add EffectQueue to state for triggering multiple sequential one-time UI effects

add-effect

Add Effect fields to state class for one-time UI notifications like snackbars, navigation, or form clearing

add-error-display

Add error state handling to widgets using context.isFailed() and context.getException()

add-fresh

Add freshness caching to prevent redundant method executions within a time period

add-loading-indicator

Add loading state tracking to widgets using context.isWaiting() for spinners and skeletons

add-non-reentrant

Add non-reentrant protection to prevent a Cubit method from running multiple times simultaneously

add-optimistic-command

Add optimisticCommand for blocking one-time actions with immediate UI updates and automatic rollback on failure

add-optimistic-sync

Add optimistic sync updates for non-blocking operations where only the final value matters and rapid changes coalesce

add-optimistic-sync-with-push

Add optimistic sync updates in apps with real-time push (like WebSocket etc) for non-blocking operations where only the final value matters and rapid changes coalesce

add-retry

Add automatic retry logic with exponential backoff to a Cubit method for transient failures

add-sequential

Add sequential queue processing to ensure Cubit method calls execute one after another in order

add-throttle

Add throttle rate limiting to prevent too-frequent method calls for refresh, scroll, or API limits

configure-global-defaults

Set global default values for RetryConfig, ThrottleConfig, DebounceConfig, and other bloc_superpowers configurations

consume-effect-queue

Add context.effectQueue() to widgets to consume and process queued effects in sequence

consume-effect

Add context.effect() to widgets to consume and react to one-time effects from state

convert-cubit

Convert an existing Cubit to use mix() function, removing manual loading and error state management

create-cubit

Create a new Cubit using mix() function for automatic loading and error state tracking

create-mix-config

Create a reusable MixConfig that bundles common mix() settings for consistent behavior across Cubits

create-mix-preset

Create a callable MixPreset function that replaces mix() with preconfigured settings

load-with-freshness

Load data with freshness caching pattern to skip redundant API calls when data is still fresh

refresh-with-throttle

Implement pull-to-refresh with throttle to prevent refresh spam and handle pagination

replace-bloc-listener

Convert BlocListener usage to Effect-based approach for clearer side effect handling

retry-until-internet

Combine checkInternet with retry.unlimited for persistent loading of critical data until connection returns

search-with-debounce

Implement search-as-you-type with debounce and loading states to avoid excessive API calls

setup-bloc-superpowers

Add bloc_superpowers package to a Flutter project with Superpowers widget and error dialog configuration

setup-global-catch-error

Configure Superpowers.globalCatchError for centralized error handling, logging, and error conversion

setup-observer

Configure Superpowers.observer for performance tracking, analytics, and debugging of all mix() calls

setup-test

Set up proper test configuration for Cubits using bloc_superpowers with Superpowers.clear() and Completers

simplify-state

Remove isLoading and errorMessage fields from state classes and use context.isWaiting() and context.isFailed() instead

test-error-state

Test isFailed() and UserException handling to verify error states work correctly

test-loading-state

Test isWaiting() behavior using Completers to verify loading states work correctly

use-composite-key

Use Dart records as composite keys for per-item or per-parameter loading and error tracking

use-props

Use Superpowers.setProp() and prop() for key-value storage with automatic cleanup on logout or test reset