Search by

jeffersongoncalves / laravel-ccpa-minors

jeffersongoncalves

CCPA/CPRA minors for Laravel (§1798.120(c)): no sale or sharing of personal information of consumers under 16 without opt-in, given by the consumer from 13 and by a parent under 13; age checks as results only.

1.0.0 2026-11-17 16:35 UTC

This package is auto-updated.

Last update: 2026-11-17 16:36:10 UTC


README

Laravel CCPA Minors

Latest Version on Packagist Tests Total Downloads

Minors under the California Consumer Privacy Act, as amended by the CPRA. It is part of the laravel-ccpa suite.

A business may not sell or share the personal information of a consumer it knows is under 16 unless that consumer opts in. Under 13, a parent or guardian has to opt in instead (Cal. Civ. Code §1798.120(c)). Willfully disregarding a consumer's age counts as knowing it.

  • Age checks as results only: you store the age, the method and the provider, never the document or birth date. Results expire. Reliable checks outweigh self-declaration, and the youngest reliable result wins.
  • Opt-in: from the consumer between 13 and 15, from a verified parent or guardian under 13. Either can take it back. A consumer's own opt-in stops counting if they turn out to be under 13.
  • One answer: allowsSaleOrSharing(), a Blade condition and a report of minors without an opt-in.
  • Adult-only routes: the ccpa.adult middleware requires a reliable adult result.

This package gives you tooling. It does not make you compliant on its own. Combine it with laravel-ccpa-opt-out: an adult's opt-out still applies.

Installation

composer require jeffersongoncalves/laravel-ccpa-minors
php artisan vendor:publish --tag="ccpa-minors-migrations"
php artisan migrate
php artisan vendor:publish --tag="ccpa-minors-config"   # optional

Usage

use JeffersonGoncalves\CcpaMinors\Enums\AssuranceMethod;
use JeffersonGoncalves\CcpaMinors\Facades\CcpaMinors;

CcpaMinors::assure($user, 14, AssuranceMethod::StoreSignal);

CcpaMinors::allowsSaleOrSharing($user);   // false: under 16, no opt-in
CcpaMinors::optIn($user);                 // 13 to 15: the consumer opts in
CcpaMinors::allowsSaleOrSharing($user);   // true
CcpaMinors::revokeOptIn($user);

Under 13, the opt-in comes from a verified parent or guardian:

$link = CcpaMinors::link($child, $parent, 'mother');
$link->verify();                          // after your verification step

CcpaMinors::optIn($child, byParent: $link);

Users with no age result are not treated as minors, since the law applies when you know the age. For a service directed to children, set treat_unknown_as_minor => true. Unknown users are then treated as under 13 and need a parent's opt-in.

The methods are self_declaration, os_signal, store_signal, document, facial_estimation, verifiable_credential and guardian. You choose which ones count as reliable in reliable_methods, and how long each is valid in valid_for.

Ad tags and adult content

@ccpaMinorSaleAllowed
    <script src="https://ads.example.com/pixel.js"></script>
@endccpaMinorSaleAllowed
Route::get('/adult', AdultController::class)->middleware(['auth', 'ccpa.adult']);

Report

php artisan ccpa:minors          # users known to be under 16 without an opt-in, and who must give it
php artisan ccpa:minors --json

Testing

composer test

Changelog

See CHANGELOG.

License

The MIT License (MIT). See License File.