Updates to the media page, and added user profile image

lib/phoenix_kit/migrations/postgres.ex

@@ -149,7 +149,7 @@ defmodule PhoenixKit.Migrations.Postgres do
   - Metadata storage for additional context in audit logs
   - Performance indexes for efficient querying by user, action, and date
 
-  ### V23 - Session Fingerprinting ⚡ LATEST
+  ### V23 - Session Fingerprinting
   - Session fingerprinting columns (ip_address, user_agent_hash) in phoenix_kit_users_tokens
   - Prevents session hijacking by detecting suspicious session usage patterns
   - IP address tracking: Detects when session is used from different IP
@@ -158,18 +158,25 @@ defmodule PhoenixKit.Migrations.Postgres do
   - Configurable strictness: Can log warnings or force re-authentication
   - Performance indexes for efficient fingerprint verification
 
+  ### V24 - File Checksum Unique Index ⚡ LATEST
+  - Unique index on phoenix_kit_files.checksum for O(1) duplicate detection
+  - Enables automatic deduplication of uploaded files
+  - Prevents redundant storage of identical files
+  - Improves performance of duplicate file lookups
+
   ## Migration Paths
 
   ### Fresh Installation (0 → Current)
-  Runs all migrations V01 through V23 in sequence.
+  Runs all migrations V01 through V24 in sequence.
 
   ### Incremental Updates
-  - V01 → V23: Runs V02 through V23 in sequence
-  - V22 → V23: Runs V23 only (adds session fingerprinting)
-  - V21 → V23: Runs V22 and V23 in sequence
-  - V20 → V23: Runs V21, V22, and V23 in sequence
+  - V01 → V24: Runs V02 through V24 in sequence
+  - V23 → V24: Runs V24 only (adds file checksum unique index)
+  - V22 → V24: Runs V23 and V24 in sequence
+  - V20 → V24: Runs V21, V22, V23, and V24 in sequence
 
   ### Rollback Support
+  - V24 → V23: Removes unique index on checksum
   - V23 → V22: Removes session fingerprinting columns and indexes
   - V22 → V21: Removes audit logging system, email orphaned events, and email metrics
   - V21 → V20: Removes composite message ID index
@@ -186,14 +193,14 @@ defmodule PhoenixKit.Migrations.Postgres do
 
   ## Usage Examples
 
-      # Update to latest version (V23)
+      # Update to latest version (V24)
       PhoenixKit.Migrations.Postgres.up(prefix: "myapp")
 
       # Update to specific version
-      PhoenixKit.Migrations.Postgres.up(prefix: "myapp", version: 23)
+      PhoenixKit.Migrations.Postgres.up(prefix: "myapp", version: 24)
 
       # Rollback to specific version
-      PhoenixKit.Migrations.Postgres.down(prefix: "myapp", version: 22)
+      PhoenixKit.Migrations.Postgres.down(prefix: "myapp", version: 23)
 
       # Complete rollback
       PhoenixKit.Migrations.Postgres.down(prefix: "myapp", version: 0)
@@ -211,7 +218,7 @@ defmodule PhoenixKit.Migrations.Postgres do
   use Ecto.Migration
 
   @initial_version 1
-  @current_version 23
+  @current_version 25
   @default_prefix "public"
 
   @doc false

lib/phoenix_kit/migrations/postgres/v24.ex

@@ -0,0 +1,69 @@
+defmodule PhoenixKit.Migrations.Postgres.V24 do
+  @moduledoc """
+  PhoenixKit V24 Migration: File Checksum Unique Index
+
+  This migration adds a unique index on the checksum field of the phoenix_kit_files table
+  to enable efficient duplicate file detection and prevent duplicate file storage.
+
+  ## Changes
+
+  ### File Deduplication Support
+  - Adds unique index on phoenix_kit_files.checksum for O(1) duplicate lookups
+  - Enables automatic deduplication of uploaded files
+  - Prevents redundant storage of identical files
+
+  ## PostgreSQL Support
+  - Supports PostgreSQL prefix for schema isolation
+  - Creates unique index for fast duplicate detection
+  """
+  use Ecto.Migration
+
+  @doc """
+  Run the V24 file checksum indexing migration.
+
+  Handles existing duplicate checksums by keeping the oldest file and deleting newer duplicates.
+  """
+  def up(%{prefix: prefix} = _opts) do
+    # First, remove duplicate checksums by keeping the oldest file (first inserted)
+    # This ensures the migration won't fail due to existing duplicates
+    remove_duplicate_checksums(prefix)
+
+    # Create unique index on checksum for duplicate detection
+    create_if_not_exists unique_index(:phoenix_kit_files, [:checksum], prefix: prefix)
+
+    # Set version comment on phoenix_kit table for version tracking
+    execute "COMMENT ON TABLE #{prefix_table_name("phoenix_kit", prefix)} IS '24'"
+  end
+
+  @doc """
+  Rollback the V24 file checksum indexing migration.
+  """
+  def down(%{prefix: prefix} = _opts) do
+    # Drop unique index on checksum
+    drop_if_exists unique_index(:phoenix_kit_files, [:checksum], prefix: prefix)
+
+    # Update version comment on phoenix_kit table to previous version
+    execute "COMMENT ON TABLE #{prefix_table_name("phoenix_kit", prefix)} IS '23'"
+  end
+
+  # Helper function to remove duplicate checksums
+  # Keeps the oldest file (earliest inserted_at) and deletes newer duplicates
+  defp remove_duplicate_checksums(prefix) do
+    table_name = prefix_table_name("phoenix_kit_files", prefix)
+
+    sql = """
+    DELETE FROM #{table_name} f1
+    WHERE id NOT IN (
+      SELECT DISTINCT ON (checksum) id
+      FROM #{table_name}
+      ORDER BY checksum, inserted_at ASC
+    )
+    """
+
+    execute(sql)
+  end
+
+  # Helper function to build table name with prefix
+  defp prefix_table_name(table_name, nil), do: table_name
+  defp prefix_table_name(table_name, prefix), do: "#{prefix}.#{table_name}"
+end

lib/phoenix_kit/migrations/postgres/v25.ex

@@ -0,0 +1,54 @@
+defmodule PhoenixKit.Migrations.Postgres.V25 do
+  @moduledoc """
+  PhoenixKit V25 Migration: Aspect Ratio Control for Dimensions
+
+  This migration adds support for aspect ratio preservation in dimension configuration.
+  Allows users to choose between maintaining aspect ratio (width only) or fixed dimensions.
+
+  ## Changes
+
+  ### Storage Dimensions Table (phoenix_kit_storage_dimensions)
+  - Adds `maintain_aspect_ratio` boolean column (default: true)
+  - When true: Only width is used, height is calculated to preserve aspect ratio
+  - When false: Both width and height are used as fixed dimensions (for thumbnails/crops)
+
+  ## Features
+
+  - **Aspect Ratio Mode**: Responsive sizing with width-only specification
+  - **Fixed Dimension Mode**: Exact pixel dimensions for square crops/thumbnails
+  - **Per-Dimension Control**: Each variant can independently choose its mode
+  - **Default to Aspect Ratio**: All dimensions default to maintaining aspect ratio
+  """
+  use Ecto.Migration
+
+  @doc """
+  Run the V25 migration to add aspect ratio control.
+  """
+  def up(%{prefix: prefix} = _opts) do
+    # Add maintain_aspect_ratio column to dimensions table
+    alter table(:phoenix_kit_storage_dimensions, prefix: prefix) do
+      add :maintain_aspect_ratio, :boolean, default: true, null: false
+    end
+
+    # Set version comment on phoenix_kit table for version tracking
+    execute "COMMENT ON TABLE #{prefix_table_name("phoenix_kit", prefix)} IS '25'"
+  end
+
+  @doc """
+  Rollback the V25 migration.
+  """
+  def down(%{prefix: prefix} = _opts) do
+    # Remove maintain_aspect_ratio column from dimensions table
+    alter table(:phoenix_kit_storage_dimensions, prefix: prefix) do
+      remove :maintain_aspect_ratio
+    end
+
+    # Update version comment on phoenix_kit table to previous version
+    execute "COMMENT ON TABLE #{prefix_table_name("phoenix_kit", prefix)} IS '24'"
+  end
+
+  # Helper functions
+
+  defp prefix_table_name(table_name, nil), do: table_name
+  defp prefix_table_name(table_name, prefix), do: "#{prefix}.#{table_name}"
+end