core-framework 0.3.0__py3-none-any.whl

core_framework/alembic/user/alembic/script.py.mako

@@ -0,0 +1,28 @@
+"""${message}
+
+Revision ID: ${up_revision}
+Revises: ${down_revision | comma,n}
+Create Date: ${create_date}
+
+"""
+from typing import Sequence, Union
+
+from alembic import op
+import sqlalchemy as sa
+${imports if imports else ""}
+
+# revision identifiers, used by Alembic.
+revision: str = ${repr(up_revision)}
+down_revision: Union[str, Sequence[str], None] = ${repr(down_revision)}
+branch_labels: Union[str, Sequence[str], None] = ${repr(branch_labels)}
+depends_on: Union[str, Sequence[str], None] = ${repr(depends_on)}
+
+
+def upgrade() -> None:
+    """Upgrade schema."""
+    ${upgrades if upgrades else "pass"}
+
+
+def downgrade() -> None:
+    """Downgrade schema."""
+    ${downgrades if downgrades else "pass"}

core_framework/alembic/user/alembic/versions/1a8bb99726ed_remove_avatar_id_from_users.py

@@ -0,0 +1,81 @@
+"""remove avatar_id from users
+
+Revision ID: 1a8bb99726ed
+Revises: 83c98ab2a779
+Create Date: 2026-02-10 08:09:13.094952
+
+"""
+
+from alembic import op
+
+# revision identifiers, used by Alembic.
+revision: str = "1a8bb99726ed"
+down_revision: str | list[str] | None = "83c98ab2a779"
+branch_labels: str | list[str] | None = None
+depends_on: str | list[str] | None = None
+
+
+def upgrade() -> None:
+    op.execute("""
+        create or replace function log_user_update_change()
+        returns trigger as $$
+        begin
+            if tg_op = 'UPDATE' then
+                if new.username is distinct from old.username then
+                    insert into "user".user_change_history (user_id, actor_id, entity_type, field, old_value, new_value)
+                    values (new.user_id, current_setting('app.actor_id', true), 'users', 'username', old.username, new.username);
+                end if;
+                if new.role is distinct from old.role then
+                    insert into "user".user_change_history (user_id, actor_id, entity_type, field, old_value, new_value)
+                    values (new.user_id, current_setting('app.actor_id', true), 'users', 'role', old.role::text, new.role::text);
+                end if;
+            end if;
+            return new;
+        end;
+        $$ language plpgsql;
+    """)
+    op.execute("drop index if exists idx_users_created_at")
+    op.execute("""
+        create index idx_users_created_at
+        on users (created_at desc)
+        include (user_id, username, role)
+    """)
+    op.execute("""
+        alter table users
+        drop column avatar_id
+    """)
+
+
+def downgrade() -> None:
+    op.execute("""
+        alter table users
+        add column avatar_id varchar(36) null
+    """)
+    op.execute("""
+        create or replace function log_user_update_change()
+        returns trigger as $$
+        begin
+            if tg_op = 'UPDATE' then
+                if new.username is distinct from old.username then
+                    insert into "user".user_change_history (user_id, actor_id, entity_type, field, old_value, new_value)
+                    values (new.user_id, current_setting('app.actor_id', true), 'users', 'username', old.username, new.username);
+                end if;
+                if new.role is distinct from old.role then
+                    insert into "user".user_change_history (user_id, actor_id, entity_type, field, old_value, new_value)
+                    values (new.user_id, current_setting('app.actor_id', true), 'users', 'role', old.role::text, new.role::text);
+                end if;
+                if new.avatar_id is distinct from old.avatar_id then
+                    insert into "user".user_change_history (user_id, actor_id, entity_type, field, old_value, new_value)
+                    values (new.user_id, current_setting('app.actor_id', true), 'users', 'avatar_id', old.avatar_id, new.avatar_id);
+                end if;
+            end if;
+            return new;
+        end;
+        $$ language plpgsql;
+    """)
+    op.execute("drop index if exists idx_users_created_at")
+    op.execute("""
+        create index idx_users_created_at
+        on users (created_at desc)
+        include (user_id, username, role, avatar_id)
+    """)

core_framework/alembic/user/alembic/versions/2ccacf455941_improve_indexes.py

@@ -0,0 +1,34 @@
+"""improve indexes
+
+Revision ID: 2ccacf455941
+Revises: 94b973923895
+Create Date: 2026-02-08 12:04:49.377562
+
+"""
+
+from collections.abc import Sequence
+
+from alembic import op
+
+# revision identifiers, used by Alembic.
+revision: str = "2ccacf455941"
+down_revision: str | Sequence[str] | None = "94b973923895"
+branch_labels: str | Sequence[str] | None = None
+
+
+def upgrade() -> None:
+    op.execute("""
+        create index idx_user_deletions_scheduled_for
+        on user_deletions (scheduled_for)
+    """)
+
+    op.execute('set search_path to "user", extension')
+    op.execute("""
+        create index idx_users_username_trgm
+        on users using gin (username gin_trgm_ops)
+    """)
+
+
+def downgrade() -> None:
+    op.execute("drop index if exists idx_user_deletions_scheduled_for")
+    op.execute("drop index if exists idx_users_username_trgm")

core_framework/alembic/user/alembic/versions/47f47ce2110e_create_user_deletions_table.py

@@ -0,0 +1,31 @@
+"""create user_deletions table
+
+Revision ID: 47f47ce2110e
+Revises: d8b98ac6b073
+Create Date: 2026-01-15 06:32:50.121454
+
+"""
+
+from collections.abc import Sequence
+
+from alembic import op
+
+# revision identifiers, used by Alembic.
+revision: str = "47f47ce2110e"
+down_revision: str | Sequence[str] | None = "d8b98ac6b073"
+branch_labels: str | Sequence[str] | None = None
+depends_on: str | Sequence[str] | None = None
+
+
+def upgrade() -> None:
+    op.execute("""
+        create table user_deletions (
+            user_id varchar(128) primary key references users(user_id) on delete cascade,
+            scheduled_for timestamptz not null,
+            created_at timestamptz not null default now()
+        );
+    """)
+
+
+def downgrade() -> None:
+    op.execute("drop table if exists user_deletions;")

core_framework/alembic/user/alembic/versions/5976db3f0175_drop_user_states.py

@@ -0,0 +1,26 @@
+"""drop user_states
+
+Revision ID: 5976db3f0175
+Revises: cbc0f4efe84f
+Create Date: 2026-01-21 06:32:32.524025
+
+"""
+
+from collections.abc import Sequence
+
+from alembic import op
+
+# revision identifiers, used by Alembic.
+revision: str = "5976db3f0175"
+down_revision: str | Sequence[str] | None = "cbc0f4efe84f"
+branch_labels: str | Sequence[str] | None = None
+depends_on: str | Sequence[str] | None = None
+
+
+def upgrade() -> None:
+    op.execute("drop table if exists user_states;")
+    op.execute("drop type if exists user_state;")
+
+
+def downgrade() -> None:
+    pass

core_framework/alembic/user/alembic/versions/62417002cf32_add_indexes.py

@@ -0,0 +1,46 @@
+"""add indexes
+
+Revision ID: 62417002cf32
+Revises: 5976db3f0175
+Create Date: 2026-02-04 12:34:27.662946
+
+"""
+
+from collections.abc import Sequence
+
+from alembic import op
+
+revision: str = "62417002cf32"
+down_revision: str | Sequence[str] | None = "5976db3f0175"
+branch_labels: str | Sequence[str] | None = None
+depends_on: str | Sequence[str] | None = None
+
+
+def upgrade() -> None:
+    op.execute("""
+        create index idx_users_created_at
+        on users (created_at desc)
+        include (user_id, username, role, avatar_id)
+    """)
+
+    op.execute("""
+        create index idx_user_blocks_blocker_created
+        on user_blocks (blocker_id, created_at desc)
+    """)
+
+    op.execute("""
+        create index idx_user_login_events_user_id
+        on user_login_events (user_id)
+    """)
+
+    op.execute("""
+        create index idx_user_blocks_blocked_id
+        on user_blocks (blocked_id)
+    """)
+
+
+def downgrade() -> None:
+    op.execute("drop index if exists idx_users_created_at")
+    op.execute("drop index if exists idx_user_blocks_blocker_created")
+    op.execute("drop index if exists idx_user_login_events_user_id")
+    op.execute("drop index if exists idx_user_blocks_blocked_id")

core_framework/alembic/user/alembic/versions/6f7ccf3c226b_refactor_user_login_events.py

@@ -0,0 +1,66 @@
+"""refactor user_login_events
+
+Revision ID: 6f7ccf3c226b
+Revises: 73432817015b
+Create Date: 2026-03-01 08:18:47.625133
+
+"""
+
+from collections.abc import Sequence
+
+from alembic import op
+
+# revision identifiers, used by Alembic.
+revision: str = "6f7ccf3c226b"
+down_revision: str | Sequence[str] | None = "73432817015b"
+branch_labels: str | Sequence[str] | None = None
+depends_on: str | Sequence[str] | None = None
+
+
+def upgrade() -> None:
+    op.execute("drop table if exists user_login_events;")
+    op.execute("drop table if exists user_devices;")
+    op.execute("""
+        create table user_login_events (
+            id bigint generated always as identity primary key,
+            user_id varchar(128) not null references users(user_id) on delete cascade,
+            created_at timestamptz not null default now(),
+            request_context jsonb not null default '{}'::jsonb
+        );
+    """)
+    op.execute("""
+        create index idx_user_login_events_user_id_created_at
+        on user_login_events (user_id, created_at);
+    """)
+
+
+def downgrade() -> None:
+    op.execute("drop index if exists idx_user_login_events_user_id_created_at;")
+    op.execute("drop table if exists user_login_events;")
+    op.execute("""
+        create table user_devices (
+            id bigint generated always as identity primary key,
+            device_key text not null unique,
+            device_type text not null,
+            first_seen_at timestamptz not null default now(),
+            last_seen_at timestamptz not null default now(),
+            login_count bigint not null default 0
+        );
+    """)
+    op.execute("""
+        create table user_login_events (
+            id bigint generated always as identity primary key,
+            user_id varchar(128) not null references users(user_id) on delete cascade,
+            created_at timestamptz not null default now(),
+            user_device_id bigint null references user_devices(id) on delete set null,
+            provider text not null,
+            user_agent text,
+            ip_address inet,
+            country_code varchar(2) not null,
+            constraint country_code_format check (country_code ~ '^[A-Z]{2}$')
+        );
+    """)
+    op.execute("""
+        create index idx_user_login_events_user_id
+        on user_login_events (user_id);
+    """)

core_framework/alembic/user/alembic/versions/73432817015b_add_user_preferences_table.py

@@ -0,0 +1,33 @@
+"""add user_preferences table
+
+Revision ID: 73432817015b
+Revises: 1a8bb99726ed
+Create Date: 2026-02-16 06:08:24.726281
+
+"""
+
+from collections.abc import Sequence
+
+from alembic import op
+
+# revision identifiers, used by Alembic.
+revision: str = "73432817015b"
+down_revision: str | Sequence[str] | None = "1a8bb99726ed"
+branch_labels: str | Sequence[str] | None = None
+depends_on: str | Sequence[str] | None = None
+
+
+def upgrade() -> None:
+    op.execute("""
+        create table user_preferences (
+            user_id varchar(128) primary key references users(user_id) on delete cascade,
+            theme varchar(20) not null default 'system',
+            language varchar(10) not null default 'en',
+            created_at timestamptz not null default now(),
+            updated_at timestamptz not null default now()
+        )
+    """)
+
+
+def downgrade() -> None:
+    op.execute("drop table if exists user_preferences;")

core_framework/alembic/user/alembic/versions/765bc01a7a59_create_user_blocks_table.py

@@ -0,0 +1,33 @@
+"""create user_blocks table
+
+Revision ID: 765bc01a7a59
+Revises: ddb70cc09d16
+Create Date: 2025-12-28 07:11:48.877991
+
+"""
+
+from collections.abc import Sequence
+
+from alembic import op
+
+# revision identifiers, used by Alembic.
+revision: str = "765bc01a7a59"
+down_revision: str | Sequence[str] | None = "ddb70cc09d16"
+branch_labels: str | Sequence[str] | None = None
+depends_on: str | Sequence[str] | None = None
+
+
+def upgrade() -> None:
+    op.execute("""
+        create table user_blocks (
+            blocker_id varchar(128) not null references users(user_id) on delete cascade,
+            blocked_id varchar(128) not null references users(user_id) on delete cascade,
+            created_at timestamptz not null default now(),
+            primary key (blocker_id, blocked_id),
+            constraint no_self_block check (blocker_id != blocked_id)
+        );
+    """)
+
+
+def downgrade() -> None:
+    op.execute("drop table if exists user_blocks")

core_framework/alembic/user/alembic/versions/7a56631f9927_create_user_login_events_table.py

@@ -0,0 +1,49 @@
+"""create user_login_events table
+
+Revision ID: 7a56631f9927
+Revises: 765bc01a7a59
+Create Date: 2025-12-28 07:23:14.355428
+
+"""
+
+from collections.abc import Sequence
+
+from alembic import op
+
+# revision identifiers, used by Alembic.
+revision: str = "7a56631f9927"
+down_revision: str | Sequence[str] | None = "765bc01a7a59"
+branch_labels: str | Sequence[str] | None = None
+depends_on: str | Sequence[str] | None = None
+
+
+def upgrade() -> None:
+    op.execute("""
+        create table user_devices (
+            id bigint generated always as identity primary key,
+            device_key text not null unique,
+            device_type text not null,
+            first_seen_at timestamptz not null default now(),
+            last_seen_at timestamptz not null default now(),
+            login_count bigint not null default 0
+        );
+    """)
+
+    op.execute("""
+        create table user_login_events (
+            id bigint generated always as identity primary key,
+            user_id varchar(128) not null references users(user_id) on delete cascade,
+            created_at timestamptz not null default now(),
+            user_device_id bigint null references user_devices(id) on delete set null,
+            provider text not null,
+            user_agent text,
+            ip_address inet,
+            country_code varchar(2) not null,
+            constraint country_code_format check (country_code ~ '^[A-Z]{2}$')
+        );
+    """)
+
+
+def downgrade() -> None:
+    op.execute("drop table if exists user_login_events")
+    op.execute("drop table if exists user_devices")

core_framework/alembic/user/alembic/versions/831611e589bc_create_user_state.py

@@ -0,0 +1,31 @@
+"""create user_state
+
+Revision ID: 831611e589bc
+Revises: f9ba10815ecd
+Create Date: 2025-12-27 09:30:08.446039
+
+"""
+
+from collections.abc import Sequence
+
+from alembic import op
+
+# revision identifiers, used by Alembic.
+revision: str = "831611e589bc"
+down_revision: str | Sequence[str] | None = "f9ba10815ecd"
+branch_labels: str | Sequence[str] | None = None
+depends_on: str | Sequence[str] | None = None
+
+
+def upgrade() -> None:
+    op.execute("""
+        create type user_state as enum (
+            'active',
+            'muted',
+            'banned'
+        );
+    """)
+
+
+def downgrade() -> None:
+    op.execute("drop type if exists user_state")

core_framework/alembic/user/alembic/versions/83c98ab2a779_add_user_profiles_table.py

@@ -0,0 +1,88 @@
+"""add user_profiles table
+
+Revision ID: 83c98ab2a779
+Revises: 2ccacf455941
+Create Date: 2026-02-09 06:15:09.093893
+
+"""
+
+from collections.abc import Sequence
+
+from alembic import op
+
+# revision identifiers, used by Alembic.
+revision: str = "83c98ab2a779"
+down_revision: str | Sequence[str] | None = "2ccacf455941"
+branch_labels: str | Sequence[str] | None = None
+depends_on: str | Sequence[str] | None = None
+
+
+def upgrade() -> None:
+    op.execute("""
+        create type profile_visibility as enum ('public', 'private', 'members_only')
+    """)
+    op.execute("""
+        create table user_profiles (
+            user_id varchar(128) primary key references users(user_id) on delete cascade,
+            avatar_id text,
+            banner_id text,
+            display_name varchar(100),
+            bio varchar(500),
+            status varchar(150),
+            social_links jsonb not null default '{}',
+            profile_visibility profile_visibility not null default 'public',
+            created_at timestamptz not null default now(),
+            updated_at timestamptz not null default now()
+        )
+    """)
+    op.execute("""
+        create or replace function log_profile_changes()
+        returns trigger as $$
+        begin
+            if tg_op = 'UPDATE' then
+                if new.avatar_id is distinct from old.avatar_id then
+                    insert into "user".user_change_history (user_id, actor_id, entity_type, field, old_value, new_value)
+                    values (new.user_id, current_setting('app.actor_id', true), 'user_profiles', 'avatar_id', old.avatar_id, new.avatar_id);
+                end if;
+                if new.banner_id is distinct from old.banner_id then
+                    insert into "user".user_change_history (user_id, actor_id, entity_type, field, old_value, new_value)
+                    values (new.user_id, current_setting('app.actor_id', true), 'user_profiles', 'banner_id', old.banner_id, new.banner_id);
+                end if;
+                if new.display_name is distinct from old.display_name then
+                    insert into "user".user_change_history (user_id, actor_id, entity_type, field, old_value, new_value)
+                    values (new.user_id, current_setting('app.actor_id', true), 'user_profiles', 'display_name', old.display_name, new.display_name);
+                end if;
+                if new.bio is distinct from old.bio then
+                    insert into "user".user_change_history (user_id, actor_id, entity_type, field, old_value, new_value)
+                    values (new.user_id, current_setting('app.actor_id', true), 'user_profiles', 'bio', old.bio, new.bio);
+                end if;
+                if new.status is distinct from old.status then
+                    insert into "user".user_change_history (user_id, actor_id, entity_type, field, old_value, new_value)
+                    values (new.user_id, current_setting('app.actor_id', true), 'user_profiles', 'status', old.status, new.status);
+                end if;
+                if new.social_links is distinct from old.social_links then
+                    insert into "user".user_change_history (user_id, actor_id, entity_type, field, old_value, new_value)
+                    values (new.user_id, current_setting('app.actor_id', true), 'user_profiles', 'social_links', old.social_links::text, new.social_links::text);
+                end if;
+                if new.profile_visibility is distinct from old.profile_visibility then
+                    insert into "user".user_change_history (user_id, actor_id, entity_type, field, old_value, new_value)
+                    values (new.user_id, current_setting('app.actor_id', true), 'user_profiles', 'profile_visibility', old.profile_visibility, new.profile_visibility);
+                end if;
+            end if;
+            return new;
+        end;
+        $$ language plpgsql;
+    """)
+    op.execute("""
+        create trigger profile_change_history_trigger
+        after update on user_profiles
+        for each row
+        execute function log_profile_changes();
+    """)
+
+
+def downgrade() -> None:
+    op.execute("drop trigger if exists profile_change_history_trigger on user_profiles;")
+    op.execute("drop function if exists log_profile_changes();")
+    op.execute("drop table if exists user_profiles;")
+    op.execute("drop type if exists profile_visibility;")

core_framework/alembic/user/alembic/versions/8a94362cad6d_create_user_role.py

@@ -0,0 +1,31 @@
+"""init users table
+
+Revision ID: 8a94362cad6d
+Revises:
+Create Date: 2025-12-26 07:49:20.727570
+
+"""
+
+from collections.abc import Sequence
+
+from alembic import op
+
+# revision identifiers, used by Alembic.
+revision: str = "8a94362cad6d"
+down_revision: str | Sequence[str] | None = None
+branch_labels: str | Sequence[str] | None = None
+depends_on: str | Sequence[str] | None = None
+
+
+def upgrade() -> None:
+    op.execute("""
+        create type user_role as enum (
+            'admin',
+            'moderator',
+            'member'
+        );
+    """)
+
+
+def downgrade() -> None:
+    op.execute("drop type if exists user_role")