Skip to content

A self-hosted media server and file management system

chore: rename date_released to released_at

aminnausinf6c9f830cafc
diff --git a/app/Http/Requests/MetadataStoreRequest.php b/app/Http/Requests/MetadataStoreRequest.php
index d56d43c3..aabdb31e 100644
--- a/app/Http/Requests/MetadataStoreRequest.php
+++ b/app/Http/Requests/MetadataStoreRequest.php
@@ -37,7 +37,7 @@ class MetadataStoreRequest extends FormRequest {
'episode' => RequestPresets::NON_NEGATIVE_INT,
'season' => RequestPresets::NON_NEGATIVE_INT,
'poster_url' => 'nullable|url',
- 'date_released' => 'nullable|date|date_format:"F d, Y"',
+ 'released_at' => 'nullable|date|date_format:Y-m-d',
'tags' => 'nullable|max:128',
'video_tags' => 'nullable|array',
'video_tags.*.name' => 'required|min:1|max:64',
diff --git a/app/Http/Requests/MetadataUpdateRequest.php b/app/Http/Requests/MetadataUpdateRequest.php
index 5e88c1f9..95ee70f3 100644
--- a/app/Http/Requests/MetadataUpdateRequest.php
+++ b/app/Http/Requests/MetadataUpdateRequest.php
@@ -38,7 +38,7 @@ class MetadataUpdateRequest extends FormRequest {
'episode' => RequestPresets::NON_NEGATIVE_INT,
'season' => RequestPresets::NON_NEGATIVE_INT,
'poster_url' => 'nullable|url',
- 'date_released' => 'nullable|date|date_format:"F d, Y"',
+ 'released_at' => 'nullable|date|date_format:Y-m-d',
'tags' => 'nullable|max:128',
'video_tags' => 'nullable|array',
'video_tags.*.name' => 'required|min:1|max:64',
diff --git a/app/Http/Resources/MetadataResource.php b/app/Http/Resources/MetadataResource.php
index 65b94e9c..d0dd19ee 100644
--- a/app/Http/Resources/MetadataResource.php
+++ b/app/Http/Resources/MetadataResource.php
@@ -22,10 +22,10 @@ class MetadataResource extends JsonResource {
'duration' => $this->duration,
'view_count' => $this->view_count,
'file_size' => $this->file_size,
- 'date_released' => $this->date_released,
- 'date_updated' => $this->updated_at,
+ 'released_at' => $this->released_at, // user provided metadata
'edited_at' => $this->edited_at, // last user edit time
'file_modified_at' => $this->file_modified_at, // file_mtime from disk (required)
+ 'date_updated' => $this->updated_at, // db update time
],
'relationships' => [
'video_id' => $this->video_id,
diff --git a/app/Http/Resources/VideoResource.php b/app/Http/Resources/VideoResource.php
index cdcd404e..d2a7cb5e 100755
--- a/app/Http/Resources/VideoResource.php
+++ b/app/Http/Resources/VideoResource.php
@@ -62,7 +62,7 @@ class VideoResource extends JsonResource {
* duration -> int4 (nullable)
* view_count -> int4 (nullable) (default=0)
*
- * date_released -> date (nullable)
+ * released_at -> date (nullable)
* date_scanned -> date (nullable)
*
* edited_at -> timestamptz (nullable)
@@ -102,7 +102,7 @@ class VideoResource extends JsonResource {
'video_tags' => VideoTagResource::collection($metadata->videoTags ?? []),
'date_created' => $this->created_at, // Date Added to Server
'date_updated' => $metadata?->updated_at ?: null, // Metadata Last Updated
- 'date_released' => $metadata?->date_released ?: null, // User Provided Release Date
+ 'released_at' => $metadata?->released_at ?: null, // User Provided Release Date in F d, Y ?
'file_modified_at' => $metadata?->file_modified_at ?: null, // File Last Modified (Should be date_added)
'edited_at' => $metadata?->edited_at,
'metadata' => $metadata,
diff --git a/app/Models/Metadata.php b/app/Models/Metadata.php
index 039b44de..d66f6d71 100644
--- a/app/Models/Metadata.php
+++ b/app/Models/Metadata.php
@@ -4,7 +4,6 @@ namespace App\Models;
use App\Enums\MediaType;
use App\Traits\HasEditableFields;
-use Carbon\Carbon;
use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\BelongsTo;
@@ -24,7 +23,7 @@ class Metadata extends Model {
* duration -> int4 (nullable)
* view_count -> int4 (nullable) (default=0)
* description -> text (nullable)
- * date_released -> date (nullable)
+ * released_at -> date (nullable)
*
* editor_id -> int8 (fk) (nullable)
* created_at -> timestamp (nullable)
@@ -76,8 +75,7 @@ class Metadata extends Model {
'poster_url',
'album',
'artist',
- // To Be Renamed
- 'date_released',
+ 'released_at',
// FFmpeg Generated
'duration',
@@ -133,10 +131,6 @@ class Metadata extends Model {
return $this->hasMany(Subtitle::class, 'metadata_uuid', 'uuid')->orderBy('track_id');
}
- public function getDateReleasedFormattedAttribute() {
- return $this->attributes['date_released'] ? Carbon::parse($this->attributes['date_released'])->format('F d, Y') : null;
- }
-
public function syncViewCountToRecords(): void {
$actual = $this->records()->count();
self::where('id', $this->id)
diff --git a/app/Services/PreviewGeneratorService.php b/app/Services/PreviewGeneratorService.php
index 106263f1..a0731c33 100644
--- a/app/Services/PreviewGeneratorService.php
+++ b/app/Services/PreviewGeneratorService.php
@@ -123,7 +123,7 @@ class PreviewGeneratorService {
$isAudio = str_starts_with($videoResource->metadata?->mime_type, 'audio');
$thumbnail = $videoResource->metadata->poster_url ?: $folder->series->thumbnail_url ?: $this->defaultThumbnail;
- $releaseDate = $this->formatDate($video->metadata->date_released ?: $video->metadata->file_modified_at);
+ $releaseDate = $this->formatDate($video->metadata->released_at ?: $video->metadata->file_modified_at);
$contentString = $releaseDate . ' • ' . $this->formatDuration($videoResource?->metadata?->duration ?? null);
$folderDateUpdated = strtotime($folderResource->series->updated_at);
diff --git a/database/migrations/2026_01_31_032947_rename_date_released_to_released_at_on_metadata.php b/database/migrations/2026_01_31_032947_rename_date_released_to_released_at_on_metadata.php
new file mode 100644
index 00000000..aff633fc
--- /dev/null
+++ b/database/migrations/2026_01_31_032947_rename_date_released_to_released_at_on_metadata.php
@@ -0,0 +1,25 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration {
+ /**
+ * Run the migrations.
+ */
+ public function up(): void {
+ Schema::table('metadata', function (Blueprint $table) {
+ $table->renameColumn('date_released', 'released_at');
+ });
+ }
+
+ /**
+ * Reverse the migrations.
+ */
+ public function down(): void {
+ Schema::table('metadata', function (Blueprint $table) {
+ $table->renameColumn('released_at', 'date_released');
+ });
+ }
+};
diff --git a/resources/js/components/forms/EditVideo.vue b/resources/js/components/forms/EditVideo.vue
index 48edce4f..fdda2160 100755
--- a/resources/js/components/forms/EditVideo.vue
+++ b/resources/js/components/forms/EditVideo.vue
@@ -128,10 +128,10 @@ const fields = reactive<FormField[]>([
default: null,
},
{
- name: 'date_released',
+ name: 'released_at',
text: 'Release Date',
type: 'date',
- value: toCalendarFormattedDate(props.video?.date_released),
+ value: toCalendarFormattedDate(props.video?.released_at),
default: null,
},
{
@@ -154,7 +154,7 @@ const form = useForm<MetadataUpdateRequest>({
episode: props.video?.episode?.toString() ?? '',
season: props.video?.season?.toString() ?? '',
poster_url: props.video?.metadata?.poster_url ?? '',
- date_released: toCalendarFormattedDate(props.video?.date_released) ?? '',
+ released_at: toCalendarFormattedDate(props.video?.released_at) ?? '',
video_tags: props.video?.video_tags ?? [],
deleted_tags: [],
});
@@ -162,9 +162,10 @@ const form = useForm<MetadataUpdateRequest>({
const handleSubmit = async () => {
form.submit(
async (fields) => {
+ const released_at = (toCalendarFormattedDate(fields.released_at, { year: 'numeric', month: '2-digit', day: '2-digit' }) ?? '').replaceAll(' ', '-');
if (props.video?.metadata?.id) {
- return mediaAPI.updateMetadata(props.video.metadata.id, fields);
- } else return mediaAPI.createMetadata({ ...fields, video_id: props.video.id });
+ return mediaAPI.updateMetadata(props.video.metadata.id, { ...fields, released_at });
+ } else return mediaAPI.createMetadata({ ...fields, video_id: props.video.id, released_at });
},
{
onSuccess: (response) => {
diff --git a/resources/js/contracts/media.ts b/resources/js/contracts/media.ts
index 54e017a1..61c86c78 100644
--- a/resources/js/contracts/media.ts
+++ b/resources/js/contracts/media.ts
@@ -67,10 +67,10 @@ export interface MetadataResource {
duration?: number;
view_count?: number;
file_size?: number;
- date_released?: string;
- date_updated?: string;
+ released_at?: string;
file_modified_at?: string;
edited_at?: string;
+ date_updated?: string;
};
relationships: {
video_id?: number;
@@ -94,7 +94,7 @@ export interface VideoResource {
file_size?: number;
video_tags: VideoTagResource[];
date_created: string;
- date_released?: string;
+ released_at?: string;
date_updated?: string;
file_modified_at?: string;
edited_at?: string;
diff --git a/resources/js/service/sort/baseSort.ts b/resources/js/service/sort/baseSort.ts
index f7948f28..6b152d99 100644
--- a/resources/js/service/sort/baseSort.ts
+++ b/resources/js/service/sort/baseSort.ts
@@ -2,7 +2,7 @@ import type { SortDir, SortKey } from '@/service/sort/types';
import { CompareStrategies } from '@/service/sort/strategies';
-export function sortObject<T>(column: keyof T, direction: SortDir = 1, dateColumns: string[] = ['date', 'date_released']) {
+export function sortObject<T>(column: keyof T, direction: SortDir = 1, dateColumns: string[] = ['updated_at', 'released_at']) {
return (a: T, b: T): number => {
const valueA = a[column];
const valueB = b[column];
diff --git a/resources/js/service/util.ts b/resources/js/service/util.ts
index 544133d7..875de639 100644
--- a/resources/js/service/util.ts
+++ b/resources/js/service/util.ts
@@ -112,11 +112,11 @@ export function formatInteger(integer: number, minimumDigits = 2) {
return integer.toLocaleString('en-CA', { minimumIntegerDigits: minimumDigits });
}
-export function toCalendarFormattedDate(date?: string) {
+export function toCalendarFormattedDate(date?: string, format: Intl.DateTimeFormatOptions = { month: 'long', day: '2-digit', year: 'numeric' }) {
if (!date) return null;
- const rawDate = new Date(date + ' EST');
- return rawDate.toLocaleDateString('en-CA', { month: 'long', day: '2-digit', year: 'numeric' }).replaceAll('.', '');
+ const rawDate = new Date(date);
+ return rawDate.toLocaleDateString('en-CA', format).replaceAll('.', '');
}
/**
diff --git a/resources/js/stores/ContentStore.ts b/resources/js/stores/ContentStore.ts
index 6d3f3ddc..6d5fbd83 100644
--- a/resources/js/stores/ContentStore.ts
+++ b/resources/js/stores/ContentStore.ts
@@ -71,7 +71,7 @@ export const useContentStore = defineStore('Content', () => {
sortCriteria = [{ compareFn: CompareStrategies.episode }];
}
- if (['date', 'date_released', 'file_modified_at'].includes(videoSort.value.column)) {
+ if (['released_at', 'file_modified_at'].includes(videoSort.value.column)) {
sortCriteria[0].compareFn = CompareStrategies.date;
}
diff --git a/resources/js/types/model.ts b/resources/js/types/model.ts
index 55410e70..d1dd87fd 100644
--- a/resources/js/types/model.ts
+++ b/resources/js/types/model.ts
@@ -26,7 +26,7 @@ export interface Metadata {
view_count?: number;
description?: string;
lyrics?: string;
- date_released?: string;
+ released_at?: string;
tags?: string;
editor_id?: number;
created_at?: string;
@@ -39,7 +39,6 @@ export interface Metadata {
resolution_width?: number;
resolution_height?: number;
frame_rate?: number;
- date_released_formatted: any;
video?: Video;
editor?: User;
poster_url?: string;
diff --git a/resources/js/types/requests.ts b/resources/js/types/requests.ts
index 98a3f33c..6bb721d9 100644
--- a/resources/js/types/requests.ts
+++ b/resources/js/types/requests.ts
@@ -11,7 +11,7 @@ export interface MetadataUpdateRequest {
episode?: string;
season?: string;
poster_url?: string;
- date_released?: string;
+ released_at?: string;
video_tags: { name: string; id: number; video_tag_id?: number }[];
deleted_tags: number[];
}
diff --git a/resources/js/views/VideoView.vue b/resources/js/views/VideoView.vue
index 3fb59c94..280dd6e2 100755
--- a/resources/js/views/VideoView.vue
+++ b/resources/js/views/VideoView.vue
@@ -85,7 +85,7 @@ const sortingOptions = computed(() => [
},
{
title: 'Date Released',
- value: 'date_released',
+ value: 'released_at',
disabled: false,
},
{