Configuration

return [
    'models' => [
        'role' => RoundlyConsulting\Permissions\Models\Role::class,
        'permission' => RoundlyConsulting\Permissions\Models\Permission::class,
    ],

    'table_names' => [
        'roles' => 'roles',
        'permissions' => 'permissions',
        'permission_role' => 'permission_role',
        'model_roles' => 'model_roles',
        'model_permissions' => 'model_permissions',
        'role_assignments' => 'role_assignments',
        'permission_assignments' => 'permission_assignments',
    ],

    'key_type' => env('PERMISSIONS_KEY_TYPE', 'bigint'),

    'register_gate_check' => true,

    'assignments' => [
        'enabled' => env('PERMISSIONS_ASSIGNMENTS', false),
        'scope_key_type' => env('PERMISSIONS_SCOPE_KEY_TYPE'),
        'global_applies_in_scope' => env('PERMISSIONS_GLOBAL_APPLIES_IN_SCOPE', true),
    ],

    'description_fallback' => env('PERMISSIONS_DESCRIPTION_FALLBACK', RoundlyConsulting\Translatable\Enums\FallbackMode::Fallback),

    'cache' => [
        'store' => env('PERMISSIONS_CACHE_STORE', 'default'),
        'key' => 'permissions.cache',
        'ttl' => env('PERMISSIONS_CACHE_TTL', 300), // seconds (at least 1)
    ],
];

# bigint | uuid | ulid — set before you publish and run the migrations
PERMISSIONS_KEY_TYPE=bigint

# Scoped and time-boxed grants — publish and run the 2.1 migrations first
PERMISSIONS_ASSIGNMENTS=false
# bigint | uuid | ulid — your scope and role-owner models; not set = PERMISSIONS_KEY_TYPE
PERMISSIONS_SCOPE_KEY_TYPE=
# false = an unscoped grant no longer counts inside a scope
PERMISSIONS_GLOBAL_APPLIES_IN_SCOPE=true

# fallback | none | any
PERMISSIONS_DESCRIPTION_FALLBACK=fallback

# "default" uses the app's default cache store
PERMISSIONS_CACHE_STORE=default
PERMISSIONS_CACHE_TTL=300

# Only when your scope models key differently from your holders — before migrating
PERMISSIONS_SCOPE_KEY_TYPE=ulid

# After the 2.1 migrations ran
PERMISSIONS_ASSIGNMENTS=true