django-cfg 1.5.15__tar.gz → 1.5.24__tar.gz

{django_cfg-1.5.15 → django_cfg-1.5.24}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: django-cfg
-Version: 1.5.15
+Version: 1.5.24
 Summary: Modern Django framework with type-safe Pydantic v2 configuration, Next.js admin integration, real-time WebSockets, and 8 enterprise apps. Replace settings.py with validated models, 90% less code. Production-ready with AI agents, auto-generated TypeScript clients, and zero-config features.
 Project-URL: Homepage, https://djangocfg.com
 Project-URL: Documentation, https://djangocfg.com
@@ -116,6 +116,7 @@ Requires-Dist: mkdocs>=1.5; extra == 'docs'
 Requires-Dist: mkdocstrings[python]>=0.24; extra == 'docs'
 Requires-Dist: pymdown-extensions>=10.0; extra == 'docs'
 Provides-Extra: full
+Requires-Dist: aiobreaker<2.0,>=1.2.0; extra == 'full'
 Requires-Dist: black>=23.0; extra == 'full'
 Requires-Dist: build>=1.0; extra == 'full'
 Requires-Dist: cent<6.0,>=5.0.0; extra == 'full'
@@ -150,6 +151,7 @@ Requires-Dist: tomlkit>=0.11; extra == 'full'
 Requires-Dist: twine>=4.0; extra == 'full'
 Requires-Dist: websockets<15.0,>=13.0; extra == 'full'
 Provides-Extra: grpc
+Requires-Dist: aiobreaker<2.0,>=1.2.0; extra == 'grpc'
 Requires-Dist: grpcio-health-checking<2.0,>=1.50.0; extra == 'grpc'
 Requires-Dist: grpcio-reflection<2.0,>=1.50.0; extra == 'grpc'
 Requires-Dist: grpcio-tools<2.0,>=1.50.0; extra == 'grpc'

{django_cfg-1.5.15 → django_cfg-1.5.24}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "django-cfg"
-version = "1.5.15"
+version = "1.5.24"
 description = "Modern Django framework with type-safe Pydantic v2 configuration, Next.js admin integration, real-time WebSockets, and 8 enterprise apps. Replace settings.py with validated models, 90% less code. Production-ready with AI agents, auto-generated TypeScript clients, and zero-config features."
 readme = "README.md"
 keywords = [ "django", "configuration", "pydantic", "settings", "type-safety", "pydantic-settings", "django-environ", "startup-validation", "ide-autocomplete", "nextjs-admin", "react-admin", "websocket", "centrifugo", "real-time", "typescript-generation", "ai-agents", "enterprise-django", "django-settings", "type-safe-config", "modern-django",]
@@ -26,13 +26,13 @@ text = "MIT"
 local = []
 django52 = [ "django>=5.2,<6.0",]
 ai = [ "pydantic-ai>=1.0.10,<2.0",]
-grpc = [ "grpcio>=1.50.0,<2.0", "grpcio-tools>=1.50.0,<2.0", "grpcio-reflection>=1.50.0,<2.0", "grpcio-health-checking>=1.50.0,<2.0", "protobuf>=5.0,<7.0",]
+grpc = [ "grpcio>=1.50.0,<2.0", "grpcio-tools>=1.50.0,<2.0", "grpcio-reflection>=1.50.0,<2.0", "grpcio-health-checking>=1.50.0,<2.0", "protobuf>=5.0,<7.0", "aiobreaker>=1.2.0,<2.0",]
 centrifugo = [ "cent>=5.0.0,<6.0", "websockets>=13.0,<15.0",]
 dev = [ "django>=5.2,<6.0", "pytest>=7.0", "pytest-django>=4.5", "pytest-cov>=4.0", "pytest-mock>=3.0", "factory-boy>=3.0", "fakeredis>=2.0", "black>=23.0", "isort>=5.0", "flake8>=5.0", "mypy>=1.0", "pre-commit>=3.0", "build>=1.0", "twine>=4.0", "tomlkit>=0.11", "questionary>=2.0", "rich>=13.0", "mkdocs>=1.5", "mkdocs-material>=9.0", "mkdocstrings[python]>=0.24", "redis>=5.0",]
 test = [ "django>=5.2,<6.0", "pytest>=7.0", "pytest-django>=4.5", "pytest-cov>=4.0", "pytest-mock>=3.0", "pytest-xdist>=3.0", "factory-boy>=3.0", "fakeredis>=2.0",]
 docs = [ "mkdocs>=1.5", "mkdocs-material>=9.0", "mkdocstrings[python]>=0.24", "pymdown-extensions>=10.0",]
 tasks = [ "redis>=5.0",]
-full = [ "django>=5.2,<6.0", "pytest>=7.0", "pytest-django>=4.5", "pytest-cov>=4.0", "pytest-mock>=3.0", "pytest-xdist>=3.0", "factory-boy>=3.0", "black>=23.0", "isort>=5.0", "flake8>=5.0", "mypy>=1.0", "pre-commit>=3.0", "build>=1.0", "twine>=4.0", "tomlkit>=0.11", "questionary>=2.0", "rich>=13.0", "mkdocs>=1.5", "mkdocs-material>=9.0", "mkdocstrings[python]>=0.24", "pymdown-extensions>=10.0", "redis>=5.0", "grpcio>=1.50.0,<2.0", "grpcio-tools>=1.50.0,<2.0", "grpcio-reflection>=1.50.0,<2.0", "grpcio-health-checking>=1.50.0,<2.0", "protobuf>=5.0,<7.0", "cent>=5.0.0,<6.0", "websockets>=13.0,<15.0", "django-rq>=3.0", "rq>=1.0", "rq-scheduler>=0.13", "hiredis>=2.0",]
+full = [ "django>=5.2,<6.0", "pytest>=7.0", "pytest-django>=4.5", "pytest-cov>=4.0", "pytest-mock>=3.0", "pytest-xdist>=3.0", "factory-boy>=3.0", "black>=23.0", "isort>=5.0", "flake8>=5.0", "mypy>=1.0", "pre-commit>=3.0", "build>=1.0", "twine>=4.0", "tomlkit>=0.11", "questionary>=2.0", "rich>=13.0", "mkdocs>=1.5", "mkdocs-material>=9.0", "mkdocstrings[python]>=0.24", "pymdown-extensions>=10.0", "redis>=5.0", "grpcio>=1.50.0,<2.0", "grpcio-tools>=1.50.0,<2.0", "grpcio-reflection>=1.50.0,<2.0", "grpcio-health-checking>=1.50.0,<2.0", "protobuf>=5.0,<7.0", "aiobreaker>=1.2.0,<2.0", "cent>=5.0.0,<6.0", "websockets>=13.0,<15.0", "django-rq>=3.0", "rq>=1.0", "rq-scheduler>=0.13", "hiredis>=2.0",]
 rq = [ "django-rq>=3.0", "rq>=1.0", "rq-scheduler>=0.13", "redis>=5.0", "hiredis>=2.0",]
 
 [project.urls]

{django_cfg-1.5.15 → django_cfg-1.5.24}/src/django_cfg/__init__.py

@@ -32,7 +32,7 @@ Example:
 default_app_config = "django_cfg.apps.DjangoCfgConfig"
 
 # Version information
-__version__ = "1.5.15"
+__version__ = "1.5.24"
 __license__ = "MIT"
 
 # Setup warnings debug early (checks env var only at this point)

{django_cfg-1.5.15 → django_cfg-1.5.24}/src/django_cfg/apps/business/accounts/serializers/profile.py

@@ -4,6 +4,24 @@ from rest_framework import serializers
 from ..models import CustomUser, RegistrationSource, UserRegistrationSource
 
 
+class CentrifugoTokenSerializer(serializers.Serializer):
+    """Nested serializer for Centrifugo WebSocket connection token."""
+
+    token = serializers.CharField(
+        help_text="JWT token for Centrifugo WebSocket connection"
+    )
+    centrifugo_url = serializers.URLField(
+        help_text="Centrifugo WebSocket URL"
+    )
+    expires_at = serializers.DateTimeField(
+        help_text="Token expiration time (ISO 8601)"
+    )
+    channels = serializers.ListField(
+        child=serializers.CharField(),
+        help_text="List of allowed channels for this user"
+    )
+
+
 class UserSerializer(serializers.ModelSerializer):
     """Serializer for user details."""
 
@@ -11,6 +29,7 @@ class UserSerializer(serializers.ModelSerializer):
     initials = serializers.ReadOnlyField()
     display_username = serializers.ReadOnlyField()
     avatar = serializers.SerializerMethodField()
+    centrifugo = serializers.SerializerMethodField()
 
     class Meta:
         model = CustomUser
@@ -31,6 +50,7 @@ class UserSerializer(serializers.ModelSerializer):
             "date_joined",
             "last_login",
             "unanswered_messages_count",
+            "centrifugo",
         ]
         read_only_fields = [
             "id",
@@ -52,6 +72,28 @@ class UserSerializer(serializers.ModelSerializer):
             return obj.avatar.url
         return None
 
+    @extend_schema_field(CentrifugoTokenSerializer(allow_null=True))
+    def get_centrifugo(self, obj):
+        """
+        Generate Centrifugo WebSocket connection token if enabled.
+
+        Returns None if Centrifugo is disabled in config.
+        """
+        try:
+            # Import here to avoid circular imports
+            from django_cfg.apps.integrations.centrifugo.services import generate_centrifugo_token
+
+            # Generate token with user's channels
+            token_data = generate_centrifugo_token(obj)
+            return token_data
+
+        except ValueError:
+            # Centrifugo not configured or disabled
+            return None
+        except Exception:
+            # If token generation fails, return None (don't break profile response)
+            return None
+
 
 
 class UserProfileUpdateSerializer(serializers.ModelSerializer):

{django_cfg-1.5.15 → django_cfg-1.5.24}/src/django_cfg/apps/business/support/serializers.py

@@ -8,13 +8,14 @@ from .models import Message, Ticket
 User = get_user_model()
 
 class SenderSerializer(serializers.ModelSerializer):
-    avatar = serializers.SerializerMethodField()
+    avatar = serializers.SerializerMethodField(allow_null=True)
     initials = serializers.ReadOnlyField()
 
     class Meta:
         model = User
         fields = ['id', 'display_username', 'email', 'avatar', 'initials', 'is_staff', 'is_superuser']
-        read_only_fields = fields
+        # Don't include avatar in read_only_fields to make it optional in OpenAPI schema
+        read_only_fields = ['id', 'display_username', 'email', 'initials', 'is_staff', 'is_superuser']
 
     def get_avatar(self, obj) -> Optional[str]:
         if obj.avatar:

{django_cfg-1.5.15 → django_cfg-1.5.24}/src/django_cfg/apps/integrations/centrifugo/__init__.py

@@ -23,6 +23,7 @@ Example:
 """
 
 from .services.client.client import CentrifugoClient, get_centrifugo_client, PublishResponse
+from .services.client.direct_client import DirectCentrifugoClient
 from .services.client.config import DjangoCfgCentrifugoConfig
 from .services.client.exceptions import (
     CentrifugoBaseException,
@@ -42,6 +43,7 @@ __all__ = [
     "DjangoCfgCentrifugoConfig",
     # Client
     "CentrifugoClient",
+    "DirectCentrifugoClient",
     "get_centrifugo_client",
     "PublishResponse",
     # Logging

{django_cfg-1.5.15 → django_cfg-1.5.24}/src/django_cfg/apps/integrations/centrifugo/apps.py

@@ -32,6 +32,7 @@ class CentrifugoConfig(AppConfig):
         Initialize app when Django starts.
 
         Validates that all required Centrifugo dependencies are installed.
+        Registers signal handlers for JWT token customization.
         """
         from django_cfg.modules.django_logging import get_logger
 
@@ -40,7 +41,7 @@ class CentrifugoConfig(AppConfig):
         # Check dependencies if needed (only when using Centrifugo features)
         self._check_dependencies_if_needed()
 
-        logger.info("Centrifugo app initialized")
+        logger.info("Centrifugo app initialized (middleware will inject JWT tokens)")
 
     def _check_dependencies_if_needed(self):
         """

django_cfg-1.5.24/src/django_cfg/apps/integrations/centrifugo/codegen/generators/typescript_thin/templates/rpc-client.ts.j2

@@ -0,0 +1,276 @@
+/**
+ * Base Centrifugo RPC Client
+ *
+ * Handles WebSocket connection and RPC call correlation.
+ * Auto-generated - DO NOT EDIT
+ */
+
+import { Centrifuge } from 'centrifuge';
+
+export class CentrifugoRPCClient {
+  private centrifuge: Centrifuge;
+  private subscription: any;
+  private channelSubscriptions: Map<string, any> = new Map();
+  private pendingRequests: Map<string, { resolve: Function; reject: Function }> = new Map();
+  private readonly replyChannel: string;
+  private readonly timeout: number;
+
+  constructor(
+    url: string,
+    token: string,
+    userId: string,
+    timeout: number = 30000
+  ) {
+    this.replyChannel = `user#${userId}`;
+    this.timeout = timeout;
+
+    this.centrifuge = new Centrifuge(url, {
+      token,
+    });
+
+    this.centrifuge.on('disconnected', (ctx) => {
+      // Reject all pending requests
+      this.pendingRequests.forEach(({ reject }) => {
+        reject(new Error('Disconnected from Centrifugo'));
+      });
+      this.pendingRequests.clear();
+    });
+  }
+
+  async connect(): Promise<void> {
+    return new Promise((resolve, reject) => {
+      let resolved = false;
+
+      // Listen to Centrifuge connection events
+      const onConnected = () => {
+        if (!resolved) {
+          resolved = true;
+          resolve();
+        }
+      };
+
+      const onError = (ctx: any) => {
+        if (!resolved) {
+          resolved = true;
+          reject(new Error(ctx.message || 'Connection error'));
+        }
+      };
+
+      this.centrifuge.on('connected', onConnected);
+      this.centrifuge.on('error', onError);
+
+      // Start connection
+      this.centrifuge.connect();
+
+      // Subscribe to reply channel
+      this.subscription = this.centrifuge.newSubscription(this.replyChannel);
+
+      this.subscription.on('publication', (ctx: any) => {
+        this.handleResponse(ctx.data);
+      });
+
+      this.subscription.on('subscribed', () => {
+        // Subscription successful (optional, we already resolved on 'connected')
+      });
+
+      this.subscription.on('error', (ctx: any) => {
+        // Error code 105 = "already subscribed" (server-side subscription from JWT)
+        // This is not an error - the channel is already active via server-side subscription
+        if (ctx.error?.code === 105) {
+          // This is fine, server-side subscription exists
+        } else {
+          console.error(`Subscription error for ${this.replyChannel}:`, ctx.error);
+        }
+      });
+
+      this.subscription.subscribe();
+    });
+  }
+
+  async disconnect(): Promise<void> {
+    // Unsubscribe from all event channels
+    this.unsubscribeAll();
+
+    // Unsubscribe from RPC reply channel
+    if (this.subscription) {
+      this.subscription.unsubscribe();
+    }
+
+    this.centrifuge.disconnect();
+  }
+
+  async call<T = any>(method: string, params: any): Promise<T> {
+    const correlationId = this.generateCorrelationId();
+
+    const message = {
+      method,
+      params,
+      correlation_id: correlationId,
+      reply_to: this.replyChannel,
+    };
+
+    // Create promise for response
+    const promise = new Promise<T>((resolve, reject) => {
+      const timeoutId = setTimeout(() => {
+        this.pendingRequests.delete(correlationId);
+        reject(new Error(`RPC timeout: ${method}`));
+      }, this.timeout);
+
+      this.pendingRequests.set(correlationId, {
+        resolve: (result: T) => {
+          clearTimeout(timeoutId);
+          resolve(result);
+        },
+        reject: (error: Error) => {
+          clearTimeout(timeoutId);
+          reject(error);
+        },
+      });
+    });
+
+    // Publish request
+    await this.centrifuge.publish('rpc.requests', message);
+
+    return promise;
+  }
+
+  private handleResponse(data: any): void {
+    const correlationId = data.correlation_id;
+    if (!correlationId) {
+      return;
+    }
+
+    const pending = this.pendingRequests.get(correlationId);
+    if (!pending) {
+      return;
+    }
+
+    this.pendingRequests.delete(correlationId);
+
+    if (data.error) {
+      pending.reject(new Error(data.error.message || 'RPC error'));
+    } else {
+      pending.resolve(data.result);
+    }
+  }
+
+  private generateCorrelationId(): string {
+    return `${Date.now()}-${Math.random().toString(36).slice(2, 11)}`;
+  }
+
+  // ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+  // Channel Subscription API (for gRPC events)
+  // ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+  /**
+   * Subscribe to a Centrifugo channel for real-time events.
+   *
+   * @param channel - Channel name (e.g., 'bot#bot-123#heartbeat')
+   * @param callback - Callback for received messages
+   * @returns Unsubscribe function
+   *
+   * @example
+   * const unsubscribe = client.subscribe('bot#bot-123#heartbeat', (data) => {
+   *   console.log('Heartbeat:', data);
+   * });
+   *
+   * // Later: unsubscribe when done
+   * unsubscribe();
+   */
+  subscribe(channel: string, callback: (data: any) => void): () => void {
+    // Check if already subscribed
+    if (this.channelSubscriptions.has(channel)) {
+      return () => {}; // Return no-op unsubscribe
+    }
+
+    // Create new subscription
+    const sub = this.centrifuge.newSubscription(channel);
+
+    // Handle publications
+    sub.on('publication', (ctx: any) => {
+      callback(ctx.data);
+    });
+
+    // Handle subscription lifecycle
+    sub.on('subscribed', () => {
+      // Subscription successful
+    });
+
+    sub.on('error', (ctx: any) => {
+      console.error(`Subscription error for ${channel}:`, ctx.error);
+    });
+
+    // Start subscription
+    sub.subscribe();
+
+    // Store subscription
+    this.channelSubscriptions.set(channel, sub);
+
+    // Return unsubscribe function
+    return () => this.unsubscribe(channel);
+  }
+
+  /**
+   * Unsubscribe from a channel.
+   *
+   * @param channel - Channel name
+   */
+  unsubscribe(channel: string): void {
+    const sub = this.channelSubscriptions.get(channel);
+    if (!sub) {
+      return;
+    }
+
+    sub.unsubscribe();
+    this.channelSubscriptions.delete(channel);
+  }
+
+  /**
+   * Unsubscribe from all channels.
+   */
+  unsubscribeAll(): void {
+    if (this.channelSubscriptions.size === 0) {
+      return;
+    }
+
+    this.channelSubscriptions.forEach((sub, channel) => {
+      sub.unsubscribe();
+    });
+    this.channelSubscriptions.clear();
+  }
+
+  /**
+   * Get list of active client-side subscriptions.
+   */
+  getActiveSubscriptions(): string[] {
+    return Array.from(this.channelSubscriptions.keys());
+  }
+
+  /**
+   * Get list of server-side subscriptions (from JWT token).
+   *
+   * These are channels automatically subscribed by Centrifugo server
+   * based on the 'channels' claim in the JWT token.
+   */
+  getServerSideSubscriptions(): string[] {
+    try {
+      // Access Centrifuge.js internal state for server-side subs
+      // @ts-ignore - accessing internal property
+      const serverSubs = this.centrifuge._serverSubs || {};
+      return Object.keys(serverSubs);
+    } catch (error) {
+      return [];
+    }
+  }
+
+  /**
+   * Get all active subscriptions (both client-side and server-side).
+   */
+  getAllSubscriptions(): string[] {
+    const clientSubs = this.getActiveSubscriptions();
+    const serverSubs = this.getServerSideSubscriptions();
+
+    // Combine and deduplicate
+    return Array.from(new Set([...clientSubs, ...serverSubs]));
+  }
+}

{django_cfg-1.5.15 → django_cfg-1.5.24}/src/django_cfg/apps/integrations/centrifugo/management/commands/generate_centrifugo_clients.py

@@ -6,6 +6,7 @@ Usage:
     python manage.py generate_centrifugo_clients -o ./clients --python --verbose
 """
 
+import logging
 from pathlib import Path
 from typing import List
 
@@ -131,11 +132,10 @@ class Command(AdminCommand):
         if not methods:
             self.stdout.write(
                 colorize(
-                    "No RPC methods found. Did you register handlers with @websocket_rpc?",
+                    "⚠️  No RPC methods found. Will generate base RPC client without API methods.",
                     fg="yellow",
                 )
             )
-            return
 
         # Create output directory
         output_dir.mkdir(parents=True, exist_ok=True)

django_cfg-1.5.24/src/django_cfg/apps/integrations/centrifugo/services/__init__.py

@@ -0,0 +1,18 @@
+"""
+Centrifugo Services.
+
+Business logic layer for Centrifugo integration.
+"""
+
+from .config_helper import get_centrifugo_config, get_centrifugo_config_or_default
+from .publisher import CentrifugoPublisher, get_centrifugo_publisher
+from .token_generator import get_user_channels, generate_centrifugo_token
+
+__all__ = [
+    "get_centrifugo_config",
+    "get_centrifugo_config_or_default",
+    "CentrifugoPublisher",
+    "get_centrifugo_publisher",
+    "get_user_channels",
+    "generate_centrifugo_token",
+]

{django_cfg-1.5.15 → django_cfg-1.5.24}/src/django_cfg/apps/integrations/centrifugo/services/client/__init__.py

@@ -1,11 +1,14 @@
 """
 Centrifugo Client.
 
-Django client for publishing messages to Centrifugo via Python Wrapper.
+Two client implementations:
+- CentrifugoClient: Via wrapper (for external API, with auth & logging)
+- DirectCentrifugoClient: Direct to Centrifugo (for internal use, lightweight)
 """
 
 from .client import CentrifugoClient, PublishResponse, get_centrifugo_client
 from .config import DjangoCfgCentrifugoConfig
+from .direct_client import DirectCentrifugoClient, get_direct_centrifugo_client
 from .exceptions import (
     CentrifugoBaseException,
     CentrifugoConfigurationError,
@@ -19,6 +22,8 @@ __all__ = [
     "DjangoCfgCentrifugoConfig",
     "CentrifugoClient",
     "get_centrifugo_client",
+    "DirectCentrifugoClient",
+    "get_direct_centrifugo_client",
     "PublishResponse",
     "CentrifugoBaseException",
     "CentrifugoTimeoutError",

{django_cfg-1.5.15 → django_cfg-1.5.24}/src/django_cfg/apps/integrations/centrifugo/services/client/client.py

@@ -396,7 +396,7 @@ class CentrifugoClient:
 
                 error_code = type(last_error).__name__ if last_error else "unknown"
                 error_message = str(last_error) if last_error else "Unknown error"
-                CentrifugoLogger.mark_failed(
+                await CentrifugoLogger.mark_failed_async(
                     log_entry,
                     error_code=error_code,
                     error_message=error_message,