django-clerk-users 0.1.2__tar.gz → 0.1.4__tar.gz

django_clerk_users-0.1.4/.claude/skills/gh-issues/SKILL.md

@@ -0,0 +1,64 @@
+---
+name: gh-issues
+description: Review open GitHub issues and start working on one. Lists issues, shows details, creates a branch, and sets up todos.
+argument-hint: "[issue-number]"
+---
+
+# GitHub Issues Skill
+
+Help the user review and start working on GitHub issues from the current repository.
+
+## Workflow
+
+### Step 1: List Open Issues
+
+If no issue number was provided as an argument, list open issues:
+
+```bash
+gh issue list --state open --limit 20
+```
+
+Present the issues in a clear format and ask the user which one they'd like to work on using AskUserQuestion. Include issue number, title, and labels.
+
+### Step 2: Get Issue Details
+
+Once an issue is selected (either from argument or user selection), fetch the full details:
+
+```bash
+gh issue view <issue-number>
+```
+
+Display:
+- Title and description
+- Labels and assignees
+- Any linked PRs or related issues
+- Comments (if relevant)
+
+### Step 3: Create a Working Branch
+
+Always create a new branch for this issue:
+
+```bash
+git checkout -b <branch-name>
+```
+
+Suggest a branch name based on the issue (e.g., `fix/123-brief-description` or `feat/123-brief-description`).
+
+### Step 4: Create Todo List
+
+Based on the issue description and any acceptance criteria, use TodoWrite to create a structured task list. Break down the work into:
+- Investigation/research tasks (if needed)
+- Implementation tasks
+- Testing tasks
+- Documentation updates (if needed)
+
+### Step 5: Start Working
+
+Begin working on the first todo item. Use the codebase exploration tools to understand the relevant code before making changes.
+
+## Important Notes
+
+- Always check `git status` before creating a branch to ensure clean working state
+- If the issue is unclear, ask clarifying questions before starting work
+- Reference the issue number in commit messages (e.g., "Fix #123: description")
+- Keep the user informed of progress by updating todos as you work

django_clerk_users-0.1.4/.claude/skills/release/SKILL.md

@@ -0,0 +1,50 @@
+---
+name: release
+description: Release a new version by bumping version, tagging, and pushing to GitHub.
+argument-hint: "[patch|minor|major|X.Y.Z]"
+---
+
+# Release Skill
+
+Release a new version of this Copier template to GitHub.
+
+## Arguments (optional)
+
+- `$ARGUMENTS` - Bump type: `patch` (default), `minor`, or `major`. Or a specific version like `0.5.0`.
+
+## Steps
+
+1. Get the current version from the latest git tag:
+   ```bash
+   git describe --tags --abbrev=0
+   ```
+
+2. Determine the new version:
+   - If no argument or `patch`: increment patch (0.2.4 -> 0.2.5)
+   - If `minor`: increment minor, reset patch (0.2.4 -> 0.3.0)
+   - If `major`: increment major, reset minor and patch (0.2.4 -> 1.0.0)
+   - If specific version provided (X.Y.Z format): use that version
+
+3. Confirm the version bump with the user using AskUserQuestion:
+   - Show current version and new version
+   - Ask for confirmation before proceeding
+
+4. Create a git tag: `v{version}`
+   ```bash
+   git tag v{version}
+   ```
+
+5. Push the tag to origin:
+   ```bash
+   git push origin v{version}
+   ```
+
+6. Report success with the new version number and a link to the GitHub releases page.
+
+## Important
+
+- Do NOT include a co-authored-by line in commits
+- The version should be in format `X.Y.Z` (e.g., `0.2.5`)
+- Tags should be prefixed with `v` (e.g., `v0.2.5`)
+- This template uses git tags as the version source (no version file to update)
+- Ensure working directory is clean before tagging

{django_clerk_users-0.1.2 → django_clerk_users-0.1.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: django-clerk-users
-Version: 0.1.2
+Version: 0.1.4
 Summary: Integrate Clerk with Django
 Project-URL: Changelog, https://github.com/jmitchel3/django-clerk-users
 Project-URL: Documentation, https://github.com/jmitchel3/django-clerk-users

{django_clerk_users-0.1.2 → django_clerk_users-0.1.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "django-clerk-users"
-version = "0.1.2"
+version = "0.1.4"
 description = "Integrate Clerk with Django"
 readme = "README.md"
 requires-python = ">=3.12"

django_clerk_users-0.1.4/src/django_clerk_users/admin.py

@@ -0,0 +1,64 @@
+"""
+Django admin configuration for ClerkUser model.
+"""
+
+from django.contrib import admin
+from django.contrib.auth.admin import UserAdmin
+
+from django_clerk_users.models import ClerkUser
+
+
+@admin.register(ClerkUser)
+class ClerkUserAdmin(UserAdmin):
+    list_display = [
+        "email",
+        "first_name",
+        "last_name",
+        "clerk_id",
+        "is_staff",
+        "is_active",
+    ]
+    list_filter = ["is_staff", "is_active", "created_at"]
+    search_fields = ["email", "first_name", "last_name", "clerk_id"]
+    ordering = ["-created_at"]
+
+    fieldsets = (
+        (None, {"fields": ("email", "password")}),
+        ("Personal info", {"fields": ("first_name", "last_name", "image_url")}),
+        ("Clerk", {"fields": ("clerk_id", "uid")}),
+        (
+            "Permissions",
+            {
+                "fields": (
+                    "is_active",
+                    "is_staff",
+                    "is_superuser",
+                    "groups",
+                    "user_permissions",
+                )
+            },
+        ),
+        (
+            "Timestamps",
+            {"fields": ("created_at", "updated_at", "last_login", "last_logout")},
+        ),
+    )
+
+    add_fieldsets = (
+        (
+            None,
+            {
+                "classes": ("wide",),
+                "fields": ("email", "password1", "password2"),
+            },
+        ),
+    )
+
+    readonly_fields = [
+        "uid",
+        "clerk_id",
+        "created_at",
+        "updated_at",
+        "last_login",
+        "last_logout",
+    ]

{django_clerk_users-0.1.2 → django_clerk_users-0.1.4}/src/django_clerk_users/apps.py

@@ -7,9 +7,6 @@ class DjangoClerkUsersConfig(AppConfig):
     default_auto_field = "django.db.models.BigAutoField"
 
     def ready(self):
-        # Import checks to register them with Django
-        from django_clerk_users import checks  # noqa: F401
-
         # Disconnect Django's update_last_login signal
         # Clerk manages authentication externally
         from django.contrib.auth import get_user_model

{django_clerk_users-0.1.2 → django_clerk_users-0.1.4}/src/django_clerk_users/authentication/utils.py

@@ -13,7 +13,11 @@ from clerk_backend_api.security.types import AuthenticateRequestOptions
 from django.core.cache import cache
 
 from django_clerk_users.client import get_clerk_client
-from django_clerk_users.exceptions import ClerkAuthenticationError, ClerkTokenError
+from django_clerk_users.exceptions import (
+    ClerkAuthenticationError,
+    ClerkConfigurationError,
+    ClerkTokenError,
+)
 from django_clerk_users.settings import CLERK_AUTH_PARTIES, CLERK_CACHE_TIMEOUT
 
 if TYPE_CHECKING:
@@ -72,7 +76,11 @@ def get_clerk_payload_from_request(request: "HttpRequest") -> dict[str, Any] | N
 
     try:
         clerk = get_clerk_client()
+    except ClerkConfigurationError:
+        # Clerk is not configured, skip authentication silently
+        return None
 
+    try:
         # Build auth options with authorized parties
         auth_options = None
         if CLERK_AUTH_PARTIES:

{django_clerk_users-0.1.2 → django_clerk_users-0.1.4}/src/django_clerk_users/management/commands/migrate_users_to_clerk.py

@@ -14,6 +14,7 @@ from django.apps import apps
 from django.core.management.base import BaseCommand, CommandError
 
 from django_clerk_users.client import get_clerk_client
+from django_clerk_users.exceptions import ClerkConfigurationError
 
 
 class Command(BaseCommand):
@@ -86,7 +87,13 @@ class Command(BaseCommand):
                 "You must specify --email, --all, or --created-before"
             )
 
-        clerk = get_clerk_client()
+        try:
+            clerk = get_clerk_client()
+        except ClerkConfigurationError:
+            raise CommandError(
+                "CLERK_SECRET_KEY is not configured. "
+                "Set it in your Django settings to use Clerk sync commands."
+            )
 
         # Build queryset
         queryset = SourceUser.objects.all()

{django_clerk_users-0.1.2 → django_clerk_users-0.1.4}/src/django_clerk_users/management/commands/sync_clerk_organizations.py

@@ -2,9 +2,10 @@
 Management command to sync organizations from Clerk to Django.
 """
 
-from django.core.management.base import BaseCommand
+from django.core.management.base import BaseCommand, CommandError
 
 from django_clerk_users.client import get_clerk_client
+from django_clerk_users.exceptions import ClerkConfigurationError
 
 
 class Command(BaseCommand):
@@ -61,7 +62,13 @@ class Command(BaseCommand):
         sync_members = options["sync_members"]
         dry_run = options["dry_run"]
 
-        clerk = get_clerk_client()
+        try:
+            clerk = get_clerk_client()
+        except ClerkConfigurationError:
+            raise CommandError(
+                "CLERK_SECRET_KEY is not configured. "
+                "Set it in your Django settings to use Clerk sync commands."
+            )
 
         created_count = 0
         updated_count = 0

{django_clerk_users-0.1.2 → django_clerk_users-0.1.4}/src/django_clerk_users/management/commands/sync_clerk_users.py

@@ -2,9 +2,10 @@
 Management command to sync users from Clerk to Django.
 """
 
-from django.core.management.base import BaseCommand
+from django.core.management.base import BaseCommand, CommandError
 
 from django_clerk_users.client import get_clerk_client
+from django_clerk_users.exceptions import ClerkConfigurationError
 from django_clerk_users.utils import update_or_create_clerk_user
 
 
@@ -41,7 +42,13 @@ class Command(BaseCommand):
         sync_all = options["all"]
         dry_run = options["dry_run"]
 
-        clerk = get_clerk_client()
+        try:
+            clerk = get_clerk_client()
+        except ClerkConfigurationError:
+            raise CommandError(
+                "CLERK_SECRET_KEY is not configured. "
+                "Set it in your Django settings to use Clerk sync commands."
+            )
 
         created_count = 0
         updated_count = 0

{django_clerk_users-0.1.2 → django_clerk_users-0.1.4}/src/django_clerk_users/middleware/auth.py

@@ -20,7 +20,10 @@ from django_clerk_users.authentication.utils import (
     get_or_create_user_from_payload,
 )
 from django_clerk_users.exceptions import ClerkAuthenticationError, ClerkTokenError
-from django_clerk_users.settings import CLERK_SESSION_REVALIDATION_SECONDS
+from django_clerk_users.settings import (
+    CLERK_SECRET_KEY,
+    CLERK_SESSION_REVALIDATION_SECONDS,
+)
 
 if TYPE_CHECKING:
     from django.http import HttpRequest, HttpResponse
@@ -81,6 +84,10 @@ class ClerkAuthMiddleware:
         request.clerk_payload = None  # type: ignore
         request.org = None  # type: ignore
 
+        # Skip Clerk authentication if not configured
+        if not CLERK_SECRET_KEY:
+            return
+
         # Check if user is already authenticated via Django's standard auth
         # (e.g., admin login with username/password)
         if hasattr(request, "user") and request.user.is_authenticated:

{django_clerk_users-0.1.2 → django_clerk_users-0.1.4}/uv.lock

@@ -289,7 +289,7 @@ wheels = [
 
 [[package]]
 name = "django-clerk-users"
-version = "0.1.1"
+version = "0.1.3"
 source = { editable = "." }
 dependencies = [
     { name = "clerk-backend-api" },

django_clerk_users-0.1.2/src/django_clerk_users/checks.py

@@ -1,127 +0,0 @@
-"""
-Django system checks for django-clerk-users configuration.
-"""
-
-from django.conf import settings
-from django.core.checks import Error, Warning, register
-
-
-@register()
-def check_clerk_secret_key(app_configs, **kwargs):
-    """Check that CLERK_SECRET_KEY is configured."""
-    errors = []
-    if not getattr(settings, "CLERK_SECRET_KEY", None):
-        errors.append(
-            Error(
-                "CLERK_SECRET_KEY is not configured.",
-                hint="Set CLERK_SECRET_KEY in your Django settings.",
-                id="django_clerk_users.E001",
-            )
-        )
-    return errors
-
-
-@register()
-def check_clerk_webhook_signing_key(app_configs, **kwargs):
-    """Check that CLERK_WEBHOOK_SIGNING_KEY is configured."""
-    warnings = []
-    if not getattr(settings, "CLERK_WEBHOOK_SIGNING_KEY", None):
-        warnings.append(
-            Warning(
-                "CLERK_WEBHOOK_SIGNING_KEY is not configured.",
-                hint=(
-                    "Set CLERK_WEBHOOK_SIGNING_KEY in your Django settings "
-                    "if you plan to use Clerk webhooks."
-                ),
-                id="django_clerk_users.W001",
-            )
-        )
-    return warnings
-
-
-@register()
-def check_auth_user_model(app_configs, **kwargs):
-    """Check that AUTH_USER_MODEL is configured for Clerk."""
-    warnings = []
-    auth_user_model = getattr(settings, "AUTH_USER_MODEL", "auth.User")
-
-    # Check if using a Clerk-compatible user model
-    if not (
-        auth_user_model.startswith("django_clerk_users.")
-        or "clerk" in auth_user_model.lower()
-    ):
-        warnings.append(
-            Warning(
-                f"AUTH_USER_MODEL is set to '{auth_user_model}'.",
-                hint=(
-                    "Consider using 'django_clerk_users.ClerkUser' or a custom model "
-                    "that extends AbstractClerkUser for full Clerk integration."
-                ),
-                id="django_clerk_users.W002",
-            )
-        )
-    return warnings
-
-
-@register()
-def check_middleware_installed(app_configs, **kwargs):
-    """Check that ClerkAuthMiddleware is installed."""
-    warnings = []
-    middleware = getattr(settings, "MIDDLEWARE", [])
-
-    clerk_middleware = "django_clerk_users.middleware.ClerkAuthMiddleware"
-    if clerk_middleware not in middleware:
-        warnings.append(
-            Warning(
-                "ClerkAuthMiddleware is not in MIDDLEWARE.",
-                hint=(
-                    f"Add '{clerk_middleware}' to MIDDLEWARE in your Django settings "
-                    "for automatic Clerk authentication."
-                ),
-                id="django_clerk_users.W003",
-            )
-        )
-    return warnings
-
-
-@register()
-def check_authentication_backend(app_configs, **kwargs):
-    """Check that ClerkBackend is in AUTHENTICATION_BACKENDS."""
-    warnings = []
-    backends = getattr(settings, "AUTHENTICATION_BACKENDS", [])
-
-    clerk_backend = "django_clerk_users.authentication.ClerkBackend"
-    if clerk_backend not in backends:
-        warnings.append(
-            Warning(
-                "ClerkBackend is not in AUTHENTICATION_BACKENDS.",
-                hint=(
-                    f"Add '{clerk_backend}' to AUTHENTICATION_BACKENDS in your "
-                    "Django settings."
-                ),
-                id="django_clerk_users.W004",
-            )
-        )
-    return warnings
-
-
-@register()
-def check_frontend_hosts(app_configs, **kwargs):
-    """Check that CLERK_FRONTEND_HOSTS is configured."""
-    warnings = []
-    frontend_hosts = getattr(settings, "CLERK_FRONTEND_HOSTS", [])
-    auth_parties = getattr(settings, "CLERK_AUTH_PARTIES", [])
-
-    if not frontend_hosts and not auth_parties:
-        warnings.append(
-            Warning(
-                "CLERK_FRONTEND_HOSTS is not configured.",
-                hint=(
-                    "Set CLERK_FRONTEND_HOSTS in your Django settings to the list of "
-                    "frontend URLs that will be sending authenticated requests "
-                    "(e.g., ['https://myapp.com', 'http://localhost:3000'])."
-                ),
-                id="django_clerk_users.W005",
-            )
-        )
-    return warnings