Files
SealShare/app/Models/Share.php
T
Andreas Reinhold / reiniandClaude Opus 5.5 f9a7839ad3
linter / quality (push) Successful in 1m5s
tests / ci (8.5) (push) Successful in 3m24s
docker / build-and-push (push) Successful in 7m10s
docker / test (8.5) (push) Successful in 3m21s
docker / release (push) Successful in 4s
Release 2.3.0
A share can now hold a private text (a password, a key, a short note)
with its files or on its own. The upload page's new "Private text" card
takes up to 100 KB; the browser encrypts the text and sends it through
the same chunk pipeline as a file, flagged is_text on share_files, so it
gets the share's password, expiry, download limit and cleanup.

The recipient sees the text only after pressing "Show text", which
counts as their download, so a messenger link preview cannot use up a
share limited to one download. The text is left out of the file list,
the ZIP and the file counts; the admin dashboard marks shares that hold
one with "Text".

The website gains a Private text feature card and a fifth phone
screenshot; every screenshot is retaken.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-26 07:00:17 +02:00

110 lines
2.8 KiB
PHP

<?php
namespace App\Models;
use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\HasMany;
use Illuminate\Database\Eloquent\Relations\HasOne;
class Share extends Model
{
use HasFactory;
/**
* The expiration times an uploader can choose, by the id the upload form and Admin settings
* store: each one's label and how long a share lasts with it.
*
* @var array<string, array{label: string, interval: string}>
*/
public const EXPIRATIONS = [
'1h' => ['label' => '1 Hour', 'interval' => '1 hour'],
'24h' => ['label' => '24 Hours', 'interval' => '1 day'],
'48h' => ['label' => '48 Hours', 'interval' => '2 days'],
'7d' => ['label' => '7 Days', 'interval' => '7 days'],
'14d' => ['label' => '14 Days', 'interval' => '14 days'],
'30d' => ['label' => '30 Days', 'interval' => '30 days'],
];
protected $fillable = [
'token',
'password',
'encryption_key',
'encryption_salt',
'wrapped_key',
'expires_at',
'max_downloads',
'download_count',
'total_size',
'completed_at',
];
/**
* @return array<string, string>
*/
protected function casts(): array
{
return [
'expires_at' => 'datetime',
'max_downloads' => 'integer',
'download_count' => 'integer',
'last_downloaded_at' => 'datetime',
'total_size' => 'integer',
'encryption_key' => 'encrypted',
'completed_at' => 'datetime',
];
}
/**
* @return HasMany<ShareFile, $this>
*/
public function files(): HasMany
{
return $this->hasMany(ShareFile::class);
}
/**
* The share's private text, stored as one of its files.
*
* @return HasOne<ShareFile, $this>
*/
public function textFile(): HasOne
{
return $this->hasOne(ShareFile::class)->where('is_text', true);
}
public function hasText(): bool
{
return $this->textFile()->exists();
}
/**
* Whether the share was created: until then its files are still being uploaded and nobody
* but the uploader's page may reach it.
*/
public function isCompleted(): bool
{
return $this->completed_at !== null;
}
public function isExpired(): bool
{
return $this->expires_at && $this->expires_at->isPast();
}
public function isPasswordProtected(): bool
{
return ! is_null($this->password);
}
public function hasReachedDownloadLimit(): bool
{
return $this->max_downloads && $this->download_count >= $this->max_downloads;
}
public function getRouteKeyName(): string
{
return 'token';
}
}