django-cfg 1.4.91__py3-none-any.whl → 1.4.92__py3-none-any.whl

django_cfg/__init__.py

@@ -32,7 +32,7 @@ Example:
 default_app_config = "django_cfg.apps.DjangoCfgConfig"
 
 # Version information
-__version__ = "1.4.91"
+__version__ = "1.4.92"
 __license__ = "MIT"
 
 # Import registry for organized lazy loading

django_cfg/modules/django_client/management/commands/generate_client.py

@@ -571,13 +571,19 @@ class Command(BaseCommand):
 
             self.stdout.write(f"\n📦 Copying TypeScript clients to Next.js admin...")
 
-            # Copy each group
+            # Copy each group (exclude 'cfg' for Next.js admin)
             copied_count = 0
             for group_dir in ts_source.iterdir():
                 if not group_dir.is_dir():
                     continue
 
                 group_name = group_dir.name
+
+                # Skip 'cfg' group for Next.js admin
+                if group_name == 'cfg':
+                    self.stdout.write(f"  ⏭️  Skipping 'cfg' group (excluded from Next.js admin)")
+                    continue
+
                 target_dir = api_output_path / group_name
 
                 # Remove old

django_cfg/modules/django_unfold/navigation.py

@@ -48,7 +48,6 @@ class NavigationManager(BaseCfgModule):
                 collapsible=True,
                 items=[
                     NavigationItem(title="Overview", icon=Icons.DASHBOARD, link=str(reverse_lazy("admin:index"))),
-                    NavigationItem(title="Frontend Admin", icon=Icons.WEB_ASSET, link="/cfg/admin/"),
                     NavigationItem(title="Settings", icon=Icons.SETTINGS, link=str(reverse_lazy("admin:constance_config_changelist"))),
                     NavigationItem(title="Health Check", icon=Icons.HEALTH_AND_SAFETY, link=str(reverse_lazy("django_cfg_drf_health"))),
                     NavigationItem(title="Endpoints Status", icon=Icons.API, link=str(reverse_lazy("endpoints_status_drf"))),

django_cfg/modules/nextjs_admin/views.py

@@ -118,27 +118,23 @@ class NextJsAdminView(LoginRequiredMixin, View):
         Resolve SPA path with Next.js routing conventions.
 
         Resolution order:
-        1. Default to iframe_route for empty path
+        1. Default to /admin for empty path or /admin path
         2. Exact file match (static assets)
         3. path/index.html (SPA routes)
         4. path.html (single page)
         5. Fallback to index.html
 
         Examples:
-            '' → 'private.html' (from iframe_route)
-            'private/centrifugo' → 'private/centrifugo/index.html'
+            '' → 'admin/index.html'
+            'admin' → 'admin/index.html'
+            'admin/centrifugo' → 'admin/centrifugo/index.html'
             '_next/static/...' → '_next/static/...' (exact)
         """
-        # Empty path - use iframe_route
-        if not path or path == '/':
-            iframe_route = nextjs_config.get_iframe_route().strip('/')
-            # Try iframe_route.html or iframe_route/index.html
-            html_file = base_dir / f"{iframe_route}.html"
-            if html_file.exists():
-                return f"{iframe_route}.html"
-            index_file = base_dir / iframe_route / 'index.html'
-            if index_file.exists():
-                return f"{iframe_route}/index.html"
+        # Empty path or 'admin' - serve /admin route
+        if not path or path == '/' or path == 'admin' or path == 'admin/':
+            admin_index = base_dir / 'admin' / 'index.html'
+            if admin_index.exists():
+                return 'admin/index.html'
             # Fallback to root index.html
             return 'index.html'
 

django_cfg/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "django-cfg"
-version = "1.4.91"
+version = "1.4.92"
 description = "Django AI framework with built-in agents, type-safe Pydantic v2 configuration, and 8 enterprise apps. Replace settings.py, validate at startup, 90% less code. Production-ready AI workflows for Django."
 readme = "README.md"
 keywords = [ "django", "configuration", "pydantic", "settings", "type-safety", "pydantic-settings", "django-environ", "startup-validation", "ide-autocomplete", "ai-agents", "enterprise-django", "django-settings", "type-safe-config",]

django_cfg/templatetags/django_cfg.py

@@ -5,13 +5,40 @@ Provides template tags for accessing django-cfg configuration constants.
 """
 
 import os
+import socket
 from django import template
+from django.conf import settings
 from django.utils.safestring import mark_safe
 from rest_framework_simplejwt.tokens import RefreshToken
 
 register = template.Library()
 
 
+def _is_port_available(host: str, port: int, timeout: float = 0.1) -> bool:
+    """
+    Check if a port is available (listening) on the specified host.
+
+    Uses a quick socket connection test with minimal timeout.
+    Returns True if the port is open and accepting connections.
+
+    Args:
+        host: Host to check (e.g., 'localhost', '127.0.0.1')
+        port: Port number to check
+        timeout: Connection timeout in seconds (default: 0.1s)
+
+    Returns:
+        bool: True if port is available, False otherwise
+    """
+    try:
+        sock = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
+        sock.settimeout(timeout)
+        result = sock.connect_ex((host, port))
+        sock.close()
+        return result == 0
+    except Exception:
+        return False
+
+
 @register.simple_tag
 def lib_name():
     """Get the library name."""
@@ -140,37 +167,42 @@ def inject_jwt_tokens_script(context):
 @register.simple_tag
 def nextjs_admin_url(path=''):
     """
-    Get the URL for Next.js Admin Panel.
+    Get the URL for Next.js Admin Panel (Built-in Dashboard - Tab 1).
 
-    In development mode (when DJANGO_CFG_FRONTEND_DEV_MODE=true):
-        Returns http://localhost:3000/{path}
+    Auto-detects development mode with priority:
+        1. If port 3000 is available → use static files (Tab 2 gets dev server)
+        2. If only port 3001 is available → http://localhost:3001/admin/{path}
+        3. Otherwise → /cfg/admin/admin/{path} (static files)
 
-    In production mode:
-        Returns /cfg/admin/{path}
+    This ensures only ONE tab shows dev server at a time.
 
     Usage in template:
         {% load django_cfg %}
-        <iframe src="{% nextjs_admin_url 'private' %}"></iframe>
-
-    Environment variable:
-        DJANGO_CFG_FRONTEND_DEV_MODE=true    # Enable dev mode
-        DJANGO_CFG_FRONTEND_DEV_PORT=3000    # Custom dev port (default: 3000)
+        <iframe src="{% nextjs_admin_url %}"></iframe>
+        <iframe src="{% nextjs_admin_url 'centrifugo' %}"></iframe>
     """
-    # Check if frontend dev mode is enabled
-    is_dev_mode = os.environ.get('DJANGO_CFG_FRONTEND_DEV_MODE', '').lower() in ('true', '1', 'yes')
-
-    # Normalize path - ensure trailing slash for Django static view
-    if path and not path.endswith('/'):
-        path = f'{path}/'
-
-    if is_dev_mode:
-        # Development mode: use Next.js dev server
-        dev_port = os.environ.get('DJANGO_CFG_FRONTEND_DEV_PORT', '3000')
-        base_url = f'http://localhost:{dev_port}'
+    # Normalize path - remove leading/trailing slashes
+    path = path.strip('/')
+
+    if not settings.DEBUG:
+        # Production mode: always use static files
+        return f'/cfg/admin/admin/{path}' if path else '/cfg/admin/admin/'
+
+    # Check which ports are available
+    port_3000_available = _is_port_available('localhost', 3000)
+    port_3001_available = _is_port_available('localhost', 3001)
+
+    # Priority: if port 3000 is running, Tab 2 gets it, Tab 1 uses static
+    if port_3000_available:
+        # Solution project is running - use static files for Tab 1
+        return f'/cfg/admin/admin/{path}' if path else '/cfg/admin/admin/'
+    elif port_3001_available:
+        # Dev project is running - use dev server for Tab 1
+        base_url = 'http://localhost:3001/admin'
         return f'{base_url}/{path}' if path else base_url
     else:
-        # Production mode: use Django static files
-        return f'/cfg/admin/{path}' if path else '/cfg/admin/'
+        # No dev server - use static files
+        return f'/cfg/admin/admin/{path}' if path else '/cfg/admin/admin/'
 
 
 @register.simple_tag
@@ -178,7 +210,11 @@ def is_frontend_dev_mode():
     """
     Check if frontend is in development mode.
 
-    Returns True if DJANGO_CFG_FRONTEND_DEV_MODE environment variable is set to true.
+    Auto-detects by checking:
+        - DEBUG=True
+        - AND (port 3000 OR port 3001 is available)
+
+    Returns True if any Next.js dev server is detected.
 
     Usage in template:
         {% load django_cfg %}
@@ -186,7 +222,12 @@ def is_frontend_dev_mode():
             <div class="dev-badge">Dev Mode</div>
         {% endif %}
     """
-    return os.environ.get('DJANGO_CFG_FRONTEND_DEV_MODE', '').lower() in ('true', '1', 'yes')
+    if not settings.DEBUG:
+        return False
+
+    # Check if either dev server is running
+    return (_is_port_available('localhost', 3000) or
+            _is_port_available('localhost', 3001))
 
 
 @register.simple_tag
@@ -214,10 +255,14 @@ def has_nextjs_external_admin():
 @register.simple_tag
 def nextjs_external_admin_url(route=''):
     """
-    Get URL for external Next.js admin (Tab 2).
+    Get URL for external Next.js admin (Tab 2 - solution project).
+
+    Auto-detects development mode:
+        - If DEBUG=True AND localhost:3000 is available → http://localhost:3000/admin/{route}
+        - Otherwise → /cfg/nextjs-admin/admin/{route} (static files)
 
-    Always returns relative URL (Django serves from static/nextjs_admin.zip):
-        Returns /cfg/nextjs-admin/{route}
+    This is for the external admin panel (solution project).
+    No env variable needed - automatically detects running dev server!
 
     Usage in template:
         {% load django_cfg %}
@@ -231,10 +276,16 @@ def nextjs_external_admin_url(route=''):
         if not config or not config.nextjs_admin:
             return ''
 
-        route = route.strip().lstrip('/')
+        route = route.strip('/')
 
-        # Always use relative URL - Django serves from extracted ZIP
-        return f"/cfg/nextjs-admin/{route}" if route else "/cfg/nextjs-admin/"
+        # Auto-detect development mode: DEBUG=True + port 3000 available
+        if settings.DEBUG and _is_port_available('localhost', 3000):
+            # Development mode: solution project on port 3000
+            base_url = 'http://localhost:3000/admin'
+            return f'{base_url}/{route}' if route else base_url
+        else:
+            # Production mode: use relative URL - Django serves from extracted ZIP with /admin prefix
+            return f"/cfg/nextjs-admin/admin/{route}" if route else "/cfg/nextjs-admin/admin/"
     except Exception:
         return ''
 

{django_cfg-1.4.91.dist-info → django_cfg-1.4.92.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: django-cfg
-Version: 1.4.91
+Version: 1.4.92
 Summary: Django AI framework with built-in agents, type-safe Pydantic v2 configuration, and 8 enterprise apps. Replace settings.py, validate at startup, 90% less code. Production-ready AI workflows for Django.
 Project-URL: Homepage, https://djangocfg.com
 Project-URL: Documentation, https://djangocfg.com

{django_cfg-1.4.91.dist-info → django_cfg-1.4.92.dist-info}/RECORD

@@ -1,5 +1,5 @@
 django_cfg/README.md,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-django_cfg/__init__.py,sha256=kj3zXzYr4WyjjFFMMWhygk3WwbqcB2fu0kwdpUhl6ok,1620
+django_cfg/__init__.py,sha256=pz7YbfETPVh0YKhFH8_iJUk4fnnsYc3GSgN4nzqt-cE,1620
 django_cfg/apps.py,sha256=72m3uuvyqGiLx6gOfE-BD3P61jddCCERuBOYpxTX518,1605
 django_cfg/config.py,sha256=y4Z3rnYsHBE0TehpwAIPaxr---mkvyKrZGGsNwYso74,1398
 django_cfg/apps/__init__.py,sha256=JtDmEYt1OcleWM2ZaeX0LKDnRQzPOavfaXBWG4ECB5Q,26
@@ -859,7 +859,7 @@ django_cfg/modules/django_client/core/validation/rules/base.py,sha256=xVJli0eSEz
 django_cfg/modules/django_client/core/validation/rules/type_hints.py,sha256=hwjTMADillsTPruDvXZQeZMj4LVV443zxY9o0Gqgg6k,10200
 django_cfg/modules/django_client/management/__init__.py,sha256=mCTPP_bIOmqNnn0WAG2n4BuF6zwc9PTgdZr_dORfNDk,54
 django_cfg/modules/django_client/management/commands/__init__.py,sha256=CJ55pHUNYQ5h-QHUe3axeTtxzlUJv7wbEuZmGN21iCM,36
-django_cfg/modules/django_client/management/commands/generate_client.py,sha256=524NucpzT93V0ODuQ_L5od7UEudYy2v4mumZ4wA9y94,30099
+django_cfg/modules/django_client/management/commands/generate_client.py,sha256=Mzc0QyxCtL814MevY7oM9wg4DtqK0rTu2MKmBpBBj08,30360
 django_cfg/modules/django_client/management/commands/validate_openapi.py,sha256=IBKk7oRP3tMQzXjvZNIgQtMPk3k_mB2diNS7bkaSLz4,11011
 django_cfg/modules/django_client/spectacular/__init__.py,sha256=M8fG-odu2ltkG36aMMr0KDkCKGX676TwdrJO8vky2cI,345
 django_cfg/modules/django_client/spectacular/async_detection.py,sha256=S_pwGR7_2SIWHjZJyiu7SCfySF3Nr3P8eqjDyBSkkLs,5731
@@ -1010,7 +1010,7 @@ django_cfg/modules/django_twilio/templates/guide.md,sha256=nZfwx-sgWyK5NApm93zOe
 django_cfg/modules/django_twilio/templates/sendgrid_otp_email.html,sha256=sXR6_D9hmOFfk9CrfPizpLddVhkRirBWpZd_ioEsxVk,6671
 django_cfg/modules/django_twilio/templates/sendgrid_test_data.json,sha256=fh1VyuSiDELHsS_CIz9gp7tlsMAEjaDOoqbAPSZ3yyo,339
 django_cfg/modules/django_unfold/__init__.py,sha256=Uquez6xgPUIc8FBMP7qif-adRYQSjQ2dBHxnJPom3eQ,1337
-django_cfg/modules/django_unfold/navigation.py,sha256=_trIm8f-K-8Nc5Gp9iEE5rKX7Bjo-Sn03GM3_oK92vI,11623
+django_cfg/modules/django_unfold/navigation.py,sha256=BSJk4NxTpkTh2Pf_NTkLf77EJSm54ta3l1-SMzYKz2U,11521
 django_cfg/modules/django_unfold/system_monitor.py,sha256=KcrTa5irstdB1pDKe3sC0zl4tz9LVjhp7xvbqUM4YVk,6781
 django_cfg/modules/django_unfold/tailwind.py,sha256=NY8nWcUdQw61oNmjPoPl7agcTb-r5IqcpFYy35MNsTM,9107
 django_cfg/modules/django_unfold/utils.py,sha256=5aFaceRc9B3eXfpOVyKRD2wWqFt8KcHxjQg54oD7Oyg,4482
@@ -1021,7 +1021,7 @@ django_cfg/modules/django_unfold/models/navigation.py,sha256=PPEeqA2HBaA1-VjADiX
 django_cfg/modules/nextjs_admin/__init__.py,sha256=lfrZYyNRExH3Z5De8G4hQBIZoFlW5Ejze3couNrztbY,312
 django_cfg/modules/nextjs_admin/apps.py,sha256=HxVUMmWTKdYpwJ00iIfWVFsBzsawsOVhEPZqjk_izjI,347
 django_cfg/modules/nextjs_admin/urls.py,sha256=7n0yStm0WNchw14Rtu_mgsIA3WKQsYP9WZt3-YOUWjU,603
-django_cfg/modules/nextjs_admin/views.py,sha256=TFnf21-e0klcjTbcmfvq-YT1fD6y_G8kKXImYuEVNSs,9857
+django_cfg/modules/nextjs_admin/views.py,sha256=SxpFQeRas0FsolZ4QNCqDEAVhncGxnDP4HtamuUsTu0,9655
 django_cfg/modules/nextjs_admin/models/__init__.py,sha256=WGw9KXcYd1O9AoA_bpMoz2gLZUlRzjGmUBjjbObcUi0,100
 django_cfg/modules/nextjs_admin/models/config.py,sha256=0ADqLuiywSCQfx_z9dkwjFCca3lr3F2uQffIjTr_QXw,5864
 django_cfg/modules/nextjs_admin/templatetags/__init__.py,sha256=ChVBnJggCIY8rMhfyJFoA8k0qKo-8FtJknrk54Vx4wM,51
@@ -1051,6 +1051,7 @@ django_cfg/static/admin/js/alpine/dashboard-tabs.js,sha256=ob8Q_I9lFLDv_hFERXgTy
 django_cfg/static/admin/js/alpine/system-metrics.js,sha256=m-Fg55K_vpHXToD46PXL9twl4OBF_V9MONvbSWbQqDw,440
 django_cfg/static/admin/js/alpine/toggle-section.js,sha256=T141NFmy0fRJyGGuuaCJRjJXwPam-xxtQNW1hi8BJbc,672
 django_cfg/static/frontend/admin.zip,sha256=n2G8ajruLqojcjqvw2pMEPjgpSTTwcmJxkeIQxJVw9U,7626768
+django_cfg/static/frontend/nextjs_admin.zip,sha256=KZMpJgmsL-Gx-la-zLCpV0W2pZ0X94IrPqNNK8fmGB0,7509389
 django_cfg/static/js/api-loader.mjs,sha256=boGqqRGnFR-Mzo_RQOjhAzNvsb7QxZddSwMKROzkk9Q,5163
 django_cfg/static/js/api/base.mjs,sha256=KUxZHHdELAV8mNnACpwJRvaQhdJxp-n5LFEQ4oUZxBo,4707
 django_cfg/static/js/api/index.mjs,sha256=_-Q04jjHcgwi4CGfiaLyiOR6NW7Yu1HBhJWp2J1cjpc,2538
@@ -1076,7 +1077,7 @@ django_cfg/templates/admin/index.html,sha256=6-f3b2IfMkK_Qog5jHzeotqn3GAeLE7JpJI
 django_cfg/templates/emails/base_email.html,sha256=TWcvYa2IHShlF_E8jf1bWZStRO0v8G4L_GexPxvz6XQ,8836
 django_cfg/templates/unfold/layouts/skeleton.html,sha256=2ArkcNZ34mFs30cOAsTQ1EZiDXcB0aVxkO71lJq9SLE,718
 django_cfg/templatetags/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-django_cfg/templatetags/django_cfg.py,sha256=spM6-33g-dHeOcKdeK8ZJMeNM98-HGg9Ta326f7ITbI,7664
+django_cfg/templatetags/django_cfg.py,sha256=7lGod6_K8AonRAUIZksluN6SWoxqQjke67D-lllMpY8,9670
 django_cfg/utils/__init__.py,sha256=64wwXJuXytvwt8Ze_erSR2HmV07nGWJ6DV5wloRBvYE,435
 django_cfg/utils/path_resolution.py,sha256=2n0I04lQkSssFaELu3A93YyMAl1K10KPdpxMt5k4Iy0,13341
 django_cfg/utils/smart_defaults.py,sha256=ZUj6K_Deq-fp5O0Dy_Emt257UWFn0f9bkgFv9YCR58U,9239
@@ -1084,9 +1085,9 @@ django_cfg/utils/version_check.py,sha256=WO51J2m2e-wVqWCRwbultEwu3q1lQasV67Mw2aa
 django_cfg/CHANGELOG.md,sha256=jtT3EprqEJkqSUh7IraP73vQ8PmKUMdRtznQsEnqDZk,2052
 django_cfg/CONTRIBUTING.md,sha256=DU2kyQ6PU0Z24ob7O_OqKWEYHcZmJDgzw-lQCmu6uBg,3041
 django_cfg/LICENSE,sha256=xHuytiUkSZCRG3N11nk1X6q1_EGQtv6aL5O9cqNRhKE,1071
-django_cfg/pyproject.toml,sha256=b-09CpZ_pSkvI6H-nr_QDNbM16IrS26fwbkpTUOo2Xs,8370
-django_cfg-1.4.91.dist-info/METADATA,sha256=dZ2bEbDGD0OVuLl7I0DsX_Snuznxhht1l4NcnfW_gUA,22624
-django_cfg-1.4.91.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-django_cfg-1.4.91.dist-info/entry_points.txt,sha256=Ucmde4Z2wEzgb4AggxxZ0zaYDb9HpyE5blM3uJ0_VNg,56
-django_cfg-1.4.91.dist-info/licenses/LICENSE,sha256=xHuytiUkSZCRG3N11nk1X6q1_EGQtv6aL5O9cqNRhKE,1071
-django_cfg-1.4.91.dist-info/RECORD,,
+django_cfg/pyproject.toml,sha256=HlcU42lQgCt8Qn4XJAjcIuIaU2X1wsjmzqMV-9G0fKI,8370
+django_cfg-1.4.92.dist-info/METADATA,sha256=CiXTzDGbsjBbZ7aDnUUNERfR1FR8Kz_VlV50BAOjUNM,22624
+django_cfg-1.4.92.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+django_cfg-1.4.92.dist-info/entry_points.txt,sha256=Ucmde4Z2wEzgb4AggxxZ0zaYDb9HpyE5blM3uJ0_VNg,56
+django_cfg-1.4.92.dist-info/licenses/LICENSE,sha256=xHuytiUkSZCRG3N11nk1X6q1_EGQtv6aL5O9cqNRhKE,1071
+django_cfg-1.4.92.dist-info/RECORD,,