prism-models 0.7.6__tar.gz → 0.7.7__tar.gz

{prism_models-0.7.6 → prism_models-0.7.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: prism-models
-Version: 0.7.6
+Version: 0.7.7
 Requires-Python: >=3.12
 Requires-Dist: sqlalchemy[asyncio]>=2.0.0
 Requires-Dist: alembic>=1.16.0

{prism_models-0.7.6 → prism_models-0.7.7}/prism_models/__init__.py

@@ -17,6 +17,7 @@ from prism_models.chat import Contact, Conversation, ConversationMessage, Conver
 from prism_models.content import Chunk, ChunkConfig, Collection, CollectionDocument, Document, IntegrationConfig, Source, Vector
 from prism_models.feedback import Augmentation, Feedback, FeedbackAnalysis, FeedbackStatus, FeedbackType
 from prism_models.qdrant import QdrantVectorPayload, DestinationVectorPayload, PydanticType
+from prism_models.notification import NotificationTarget, NotificationOutbox
 
 __all__ = [
     "POSTGRES_NAMING_CONVENTION",
@@ -51,4 +52,6 @@ __all__ = [
     "Source",
     "TimestampMixin",
     "Vector",
+    "NotificationTarget",
+    "NotificationOutbox",
 ]

prism_models-0.7.7/prism_models/migration/versions/2026_01_29_1312_ed197421f25a_add_notification_tables.py

@@ -0,0 +1,87 @@
+"""add notification tables
+
+Revision ID: ed197421f25a
+Revises: 53d6d0b55f11
+Create Date: 2026-01-29 13:12:33.275063
+
+"""
+from typing import Sequence, Union
+
+from alembic import op
+import sqlalchemy as sa
+from sqlalchemy.dialects import postgresql
+
+# revision identifiers, used by Alembic.
+revision: str = 'ed197421f25a'
+down_revision: Union[str, Sequence[str], None] = '53d6d0b55f11'
+branch_labels: Union[str, Sequence[str], None] = None
+depends_on: Union[str, Sequence[str], None] = None
+
+
+def upgrade() -> None:
+    """Upgrade schema."""
+    # ### commands auto generated by Alembic - please adjust! ###
+    op.create_table('notification_target',
+    sa.Column('provider', sa.String(length=50), nullable=False),
+    sa.Column('target_key', sa.String(length=100), nullable=False),
+    sa.Column('display_name', sa.String(length=255), nullable=True),
+    sa.Column('webhook_url', sa.Text(), nullable=False),
+    sa.Column('is_enabled', sa.Boolean(), nullable=False),
+    sa.Column('id', sa.Integer(), nullable=False),
+    sa.Column('created_at', sa.DateTime(timezone=True), server_default=sa.text('now()'), nullable=False),
+    sa.Column('updated_at', sa.DateTime(timezone=True), server_default=sa.text('now()'), nullable=False),
+    sa.Column('deleted_at', sa.DateTime(timezone=True), nullable=True),
+    sa.PrimaryKeyConstraint('id', name=op.f('notification_target_pkey')),
+    sa.UniqueConstraint('provider', 'target_key', name='uq_notification_target_provider_key')
+    )
+    op.create_index(op.f('notification_target_id_idx'), 'notification_target', ['id'], unique=False)
+    op.create_table('notification_outbox',
+    sa.Column('provider', sa.String(length=50), nullable=False),
+    sa.Column('target_key', sa.String(length=100), nullable=False),
+    sa.Column('event_type', sa.String(length=100), nullable=False),
+    sa.Column('severity', sa.String(length=20), nullable=True),
+    sa.Column('dedupe_key', sa.String(length=255), nullable=False),
+    sa.Column('correlation_id', sa.String(length=100), nullable=True),
+    sa.Column('entity_type', sa.String(length=50), nullable=True),
+    sa.Column('entity_id', sa.String(length=100), nullable=True),
+    sa.Column('payload', postgresql.JSONB(astext_type=sa.Text()), nullable=False),
+    sa.Column('status', sa.String(length=20), nullable=False),
+    sa.Column('priority', sa.Integer(), nullable=False),
+    sa.Column('attempts', sa.Integer(), nullable=False),
+    sa.Column('max_attempts', sa.Integer(), nullable=False),
+    sa.Column('next_attempt_at', sa.DateTime(timezone=True), server_default=sa.text('now()'), nullable=False),
+    sa.Column('last_error', sa.Text(), nullable=True),
+    sa.Column('sent_at', sa.DateTime(timezone=True), nullable=True),
+    sa.Column('expires_at', sa.DateTime(timezone=True), nullable=True),
+    sa.Column('locked_by', sa.String(length=100), nullable=True),
+    sa.Column('locked_at', sa.DateTime(timezone=True), nullable=True),
+    sa.Column('id', sa.Integer(), nullable=False),
+    sa.Column('created_at', sa.DateTime(timezone=True), server_default=sa.text('now()'), nullable=False),
+    sa.Column('updated_at', sa.DateTime(timezone=True), server_default=sa.text('now()'), nullable=False),
+    sa.Column('deleted_at', sa.DateTime(timezone=True), nullable=True),
+    sa.ForeignKeyConstraint(['provider', 'target_key'], ['notification_target.provider', 'notification_target.target_key'], name='fk_notification_outbox_target'),
+    sa.PrimaryKeyConstraint('id', name=op.f('notification_outbox_pkey')),
+    sa.UniqueConstraint('dedupe_key', name=op.f('notification_outbox_dedupe_key_key'))
+    )
+    op.create_index('ix_notification_outbox_entity', 'notification_outbox', ['entity_type', 'entity_id'], unique=False)
+    op.create_index('ix_notification_outbox_ready', 'notification_outbox', ['status', 'priority', 'next_attempt_at'], unique=False)
+    op.create_index(op.f('notification_outbox_correlation_id_idx'), 'notification_outbox', ['correlation_id'], unique=False)
+    op.create_index(op.f('notification_outbox_expires_at_idx'), 'notification_outbox', ['expires_at'], unique=False)
+    op.create_index(op.f('notification_outbox_id_idx'), 'notification_outbox', ['id'], unique=False)
+    op.create_index(op.f('notification_outbox_status_idx'), 'notification_outbox', ['status'], unique=False)
+    # ### end Alembic commands ###
+
+
+def downgrade() -> None:
+    """Downgrade schema."""
+    # ### commands auto generated by Alembic - please adjust! ###
+    op.drop_index(op.f('notification_outbox_status_idx'), table_name='notification_outbox')
+    op.drop_index(op.f('notification_outbox_id_idx'), table_name='notification_outbox')
+    op.drop_index(op.f('notification_outbox_expires_at_idx'), table_name='notification_outbox')
+    op.drop_index(op.f('notification_outbox_correlation_id_idx'), table_name='notification_outbox')
+    op.drop_index('ix_notification_outbox_ready', table_name='notification_outbox')
+    op.drop_index('ix_notification_outbox_entity', table_name='notification_outbox')
+    op.drop_table('notification_outbox')
+    op.drop_index(op.f('notification_target_id_idx'), table_name='notification_target')
+    op.drop_table('notification_target')
+    # ### end Alembic commands ###

prism_models-0.7.7/prism_models/notification.py

@@ -0,0 +1,142 @@
+"""Notification models for outbox-based delivery to Teams channels."""
+
+import enum
+from datetime import datetime
+from typing import Optional
+
+from sqlalchemy import (
+    Boolean,
+    DateTime,
+    ForeignKeyConstraint,
+    Index,
+    Integer,
+    String,
+    Text,
+    UniqueConstraint,
+    func,
+)
+from sqlalchemy.dialects.postgresql import JSONB
+from sqlalchemy.orm import Mapped, mapped_column, relationship
+
+from prism_models.base import Base, BaseModel, TimestampMixin
+
+
+# ─────────────────────────────────────────────────────────────────────────────
+# Enums
+# ─────────────────────────────────────────────────────────────────────────────
+
+
+class NotificationStatus(str, enum.Enum):
+    """Lifecycle states for outbox notifications."""
+
+    PENDING = "pending"
+    SENDING = "sending"
+    SENT = "sent"
+    FAILED = "failed"
+
+
+class NotificationSeverity(str, enum.Enum):
+    """Severity levels for notification prioritization and formatting."""
+
+    INFO = "info"
+    WARN = "warn"
+    ERROR = "error"
+    CRITICAL = "critical"
+
+
+class NotificationProvider(str, enum.Enum):
+    """Supported notification providers (only Teams for now)."""
+
+    TEAMS = "teams"
+
+class NotificationTarget(BaseModel):
+    """
+    Webhook destinations for notifications.
+
+    Each target represents a Teams channel webhook.
+    Multiple event types can route to the same target.
+    """
+
+    __tablename__ = "notification_target"
+
+    provider: Mapped[str] = mapped_column(String(50), nullable=False)
+    target_key: Mapped[str] = mapped_column(String(100), nullable=False)
+    display_name: Mapped[str | None] = mapped_column(String(255), nullable=True)
+    webhook_url: Mapped[str] = mapped_column(Text, nullable=False)
+    is_enabled: Mapped[bool] = mapped_column(Boolean, default=True, nullable=False)
+
+    outbox_entries: Mapped[list["NotificationOutbox"]] = relationship(
+        back_populates="target",
+        foreign_keys="[NotificationOutbox.provider, NotificationOutbox.target_key]",
+    )
+
+    __table_args__ = (
+        UniqueConstraint("provider", "target_key", name="uq_notification_target_provider_key"),
+    )
+
+    def __repr__(self):
+        return f"<NotificationTarget(id={self.id}, provider='{self.provider}', key='{self.target_key}')>"
+
+
+class NotificationOutbox(BaseModel):
+    """
+    Transactional outbox for reliable notification delivery.
+
+    Design notes:
+    - dedupe_key: Prevents duplicate sends at insert time
+    - entity_type + entity_id: Polymorphic reference to source entity
+    - locked_by + locked_at: Enables safe multi-worker polling
+    - priority: Critical alerts jump ahead of digests
+    - max_attempts: Per-notification retry limit
+    - expires_at: Auto-expire stale notifications
+    """
+
+    __tablename__ = "notification_outbox"
+
+    provider: Mapped[str] = mapped_column(String(50), nullable=False)
+    target_key: Mapped[str] = mapped_column(String(100), nullable=False)
+    event_type: Mapped[str] = mapped_column(String(100), nullable=False)
+    severity: Mapped[str | None] = mapped_column(String(20), nullable=True)
+
+    dedupe_key: Mapped[str] = mapped_column(String(255), nullable=False, unique=True)
+    correlation_id: Mapped[str | None] = mapped_column(String(100), nullable=True, index=True)
+
+    entity_type: Mapped[str | None] = mapped_column(String(50), nullable=True)
+    entity_id: Mapped[str | None] = mapped_column(String(100), nullable=True)
+
+    payload: Mapped[dict] = mapped_column(JSONB, nullable=False)
+
+    status: Mapped[str] = mapped_column(
+        String(20), default=NotificationStatus.PENDING.value, nullable=False, index=True
+    )
+    priority: Mapped[int] = mapped_column(Integer, default=0, nullable=False)
+    attempts: Mapped[int] = mapped_column(Integer, default=0, nullable=False)
+    max_attempts: Mapped[int] = mapped_column(Integer, default=5, nullable=False)
+    next_attempt_at: Mapped[datetime] = mapped_column(
+        DateTime(timezone=True), server_default=func.now(), nullable=False
+    )
+    last_error: Mapped[str | None] = mapped_column(Text, nullable=True)
+    sent_at: Mapped[datetime | None] = mapped_column(DateTime(timezone=True), nullable=True)
+
+    expires_at: Mapped[datetime | None] = mapped_column(DateTime(timezone=True), nullable=True, index=True)
+
+    locked_by: Mapped[str | None] = mapped_column(String(100), nullable=True)
+    locked_at: Mapped[datetime | None] = mapped_column(DateTime(timezone=True), nullable=True)
+
+    target: Mapped[Optional["NotificationTarget"]] = relationship(
+        back_populates="outbox_entries",
+        foreign_keys=[provider, target_key],
+    )
+
+    __table_args__ = (
+        ForeignKeyConstraint(
+            ["provider", "target_key"],
+            ["notification_target.provider", "notification_target.target_key"],
+            name="fk_notification_outbox_target",
+        ),
+        Index("ix_notification_outbox_ready", "status", "priority", "next_attempt_at"),
+        Index("ix_notification_outbox_entity", "entity_type", "entity_id"),
+    )
+
+    def __repr__(self):
+        return f"<NotificationOutbox(id={self.id}, event='{self.event_type}', status='{self.status}')>"

{prism_models-0.7.6 → prism_models-0.7.7}/prism_models.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: prism-models
-Version: 0.7.6
+Version: 0.7.7
 Requires-Python: >=3.12
 Requires-Dist: sqlalchemy[asyncio]>=2.0.0
 Requires-Dist: alembic>=1.16.0

{prism_models-0.7.6 → prism_models-0.7.7}/prism_models.egg-info/SOURCES.txt

@@ -7,6 +7,7 @@ prism_models/chat.py
 prism_models/config.py
 prism_models/content.py
 prism_models/feedback.py
+prism_models/notification.py
 prism_models/qdrant.py
 prism_models.egg-info/PKG-INFO
 prism_models.egg-info/SOURCES.txt
@@ -73,4 +74,5 @@ prism_models/migration/versions/2025_12_09_1146_6abdd3f001ab_adding_orchestrator
 prism_models/migration/versions/2025_12_17_1220_4d9291a3acb1_removed_qa_pair_chunk.py
 prism_models/migration/versions/2026_01_14_1742_147509a82af8_changed_user_role_enums.py
 prism_models/migration/versions/2026_01_15_1010_3b7d0b2e9f5a_add_contact_profile_table.py
-prism_models/migration/versions/2026_01_26_1648_53d6d0b55f11_feedback_changes.py
+prism_models/migration/versions/2026_01_26_1648_53d6d0b55f11_feedback_changes.py
+prism_models/migration/versions/2026_01_29_1312_ed197421f25a_add_notification_tables.py

{prism_models-0.7.6 → prism_models-0.7.7}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "prism-models"
-version = "0.7.6"
+version = "0.7.7"
 requires-python = ">=3.12"
 dependencies = [
   "sqlalchemy[asyncio]>=2.0.0",