karrio-server-events 2026.1.3__py3-none-any.whl → 2026.1.5__py3-none-any.whl

karrio/server/events/serializers/base.py

@@ -12,6 +12,9 @@ class EventTypes(lib.StrEnum):
     shipment_delivery_failed = "shipment_delivery_failed"
     tracker_created = "tracker_created"
     tracker_updated = "tracker_updated"
+    pickup_scheduled = "pickup_scheduled"
+    pickup_cancelled = "pickup_cancelled"
+    pickup_closed = "pickup_closed"
     order_created = "order_created"
     order_updated = "order_updated"
     order_fulfilled = "order_fulfilled"

karrio/server/events/signals.py

@@ -13,6 +13,7 @@ def register_signals():
     signals.post_save.connect(shipment_updated, sender=models.Shipment)
     signals.post_delete.connect(shipment_cancelled, sender=models.Shipment)
     signals.post_save.connect(tracker_updated, sender=models.Tracking)
+    signals.post_save.connect(pickup_updated, sender=models.Pickup)
 
     logger.info("Karrio events signals registered")
 
@@ -134,3 +135,47 @@ def tracker_updated(
         return
 
     tasks.notify_webhooks(event, data, event_at, context, schema=settings.schema)
+
+
+@utils.disable_for_loaddata
+@utils.error_wrapper
+def pickup_updated(
+    sender, instance, created, raw, using, update_fields, *args, **kwargs
+):
+    """Pickup related events:
+    - pickup scheduled (created)
+    - pickup cancelled (status changed to cancelled)
+    - pickup closed (status changed to closed)
+    """
+    changes = update_fields or []
+    status_updated = "status" in changes
+
+    if created:
+        event = EventTypes.pickup_scheduled.value
+    elif (
+        status_updated
+        and instance.status == serializers.PickupStatus.cancelled.value
+    ):
+        event = EventTypes.pickup_cancelled.value
+    elif (
+        status_updated
+        and instance.status == serializers.PickupStatus.closed.value
+    ):
+        event = EventTypes.pickup_closed.value
+    else:
+        return
+
+    data = serializers.Pickup(instance).data
+    event_at = instance.updated_at
+    context = dict(
+        user_id=utils.failsafe(lambda: instance.created_by.id),
+        test_mode=instance.test_mode,
+        org_id=utils.failsafe(
+            lambda: instance.org.first().id if hasattr(instance, "org") else None
+        ),
+    )
+
+    if settings.MULTI_ORGANIZATIONS and context["org_id"] is None:
+        return
+
+    tasks.notify_webhooks(event, data, event_at, context, schema=settings.schema)

karrio/server/events/task_definitions/base/__init__.py

@@ -49,8 +49,24 @@ def periodic_data_archiving(*args, **kwargs):
     _run()
 
 
+@db_periodic_task(crontab(hour=0, minute=30))
+@with_task_telemetry("daily_pickup_close")
+def daily_pickup_close():
+    from karrio.server.events.task_definitions.base import pickup
+
+    @utils.run_on_all_tenants
+    def _run(**kwargs):
+        utils.failsafe(
+            lambda: pickup.close_past_pickups(),
+            "An error occurred during pickup auto-close: $error",
+        )
+
+    _run()
+
+
 TASK_DEFINITIONS = [
     background_trackers_update,
     periodic_data_archiving,
+    daily_pickup_close,
     notify_webhooks,
 ]

karrio/server/events/task_definitions/base/pickup.py

@@ -0,0 +1,66 @@
+import datetime
+from django.utils import timezone
+
+from karrio.server.core.logging import logger
+import karrio.server.manager.models as models
+
+
+def close_past_pickups():
+    """Auto-close one_time pickups whose pickup_date has passed.
+
+    Only closes pickups that are:
+    - Still in "scheduled" status
+    - Have pickup_type == "one_time" (stored in meta)
+    - Have a pickup_date strictly before today
+
+    Recurring and daily pickups without an end_date are excluded to avoid
+    prematurely closing open-ended recurring schedules.
+    """
+    today = timezone.now().date()
+
+    # Get all scheduled pickups with pickup_date in the past
+    past_pickups = models.Pickup.objects.filter(
+        status="scheduled",
+        pickup_date__lt=today,
+    )
+
+    # Separate one_time pickups (always close) from recurring/daily pickups
+    one_time_ids = []
+    recurring_expired_ids = []
+
+    for pickup in past_pickups.values("id", "meta"):
+        meta = pickup.get("meta") or {}
+        pickup_type = meta.get("pickup_type", "one_time")
+
+        if pickup_type == "one_time":
+            one_time_ids.append(pickup["id"])
+        elif pickup_type in ("daily", "recurring"):
+            # Only close recurring/daily pickups that have an explicit end_date
+            # that has passed. Leave open-ended recurring pickups alone.
+            recurrence = meta.get("recurrence") or {}
+            end_date_str = recurrence.get("end_date")
+
+            if end_date_str:
+                try:
+                    end_date = datetime.date.fromisoformat(end_date_str)
+                    if end_date < today:
+                        recurring_expired_ids.append(pickup["id"])
+                except (ValueError, TypeError):
+                    pass
+
+    ids_to_close = one_time_ids + recurring_expired_ids
+
+    if not ids_to_close:
+        logger.info("No past pickups to auto-close")
+        return
+
+    count = models.Pickup.objects.filter(id__in=ids_to_close).update(
+        status="closed",
+    )
+
+    logger.info(
+        "Auto-closed past pickups",
+        count=count,
+        one_time=len(one_time_ids),
+        recurring_expired=len(recurring_expired_ids),
+    )

{karrio_server_events-2026.1.3.dist-info → karrio_server_events-2026.1.5.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: karrio_server_events
-Version: 2026.1.3
+Version: 2026.1.5
 Summary: Multi-carrier shipping API Events module
 Author-email: karrio <hello@karrio.io>
 License-Expression: LGPL-3.0

{karrio_server_events-2026.1.3.dist-info → karrio_server_events-2026.1.5.dist-info}/RECORD

@@ -4,7 +4,7 @@ karrio/server/events/apps.py,sha256=DIV8JdPB_3hD4DwhcQTevhph3PaceMkFSEGM1lOcdVY,
 karrio/server/events/filters.py,sha256=vMeY42IsoFl482-yX1BI17sw-9x9euOnzTl-860W3sg,2230
 karrio/server/events/models.py,sha256=WQQKpDnbUW97beFmCBJDTckSoE-h-HtxeRfjoNWepQY,2582
 karrio/server/events/router.py,sha256=IBUR7rfBkdEHQzWxYOPcVSM8NBp3fte9G6Q5BVTUNNw,95
-karrio/server/events/signals.py,sha256=3VlwVPWEyALcjn1MEbuh3u9Xojq8hSgmwYFz7lulW3M,4544
+karrio/server/events/signals.py,sha256=PJ-E9-u7PwXEZ6CdmySPCJeUIPlnly1AVFyzF7pGZZo,5917
 karrio/server/events/tasks.py,sha256=kqs-W2VnDHOQNvieN8Ltehk578W5FTXTobj7t_mi9Xk,787
 karrio/server/events/tests.py,sha256=mrbGGRNg5jwbTJtWWa7zSKdDyeB4vmgZCRc2nk6VY-g,60
 karrio/server/events/urls.py,sha256=oLTTzDWPhEFfK93EvzHTDRxqkw8Fr3iXneDXwFUkvcU,217
@@ -20,12 +20,13 @@ karrio/server/events/migrations/0009_alter_webhook_enabled_events.py,sha256=0bhn
 karrio/server/events/migrations/0010_event_event_created_at_idx.py,sha256=9vLPYVIId5Ni4W_EnmaCfL-F29YzoQ070963D3q6KgA,498
 karrio/server/events/migrations/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 karrio/server/events/serializers/__init__.py,sha256=S5KJONM1VFbB_Wyl__F2YbdSV7R_5RPNFos0ERkfDko,52
-karrio/server/events/serializers/base.py,sha256=Civqqod7X2u8wUfQpx7NejFpQfqQD8UWjztSOX4iWzg,2158
+karrio/server/events/serializers/base.py,sha256=7D9qkzluhNVvJJYRQlyF_sjrzpTl_V-Eh9vIzhRz59g,2278
 karrio/server/events/serializers/event.py,sha256=dKYqldfSEjKMY7uB1rBFfEfSZ_dfEp8EPxbkBBSWzcc,289
 karrio/server/events/serializers/webhook.py,sha256=Ri5JS1SXpSsPUvQH989T_7Amu1p46y5TP54MEEhK8j8,889
 karrio/server/events/task_definitions/__init__.py,sha256=bpT73UG7mZL_JjEqMwbYx6q69jA8J5Jcoul1LcDokhA,81
-karrio/server/events/task_definitions/base/__init__.py,sha256=2c3k6qtrdTZ6gxV3JJIpVo7CV83xzVn0vLF8nBpud28,1622
+karrio/server/events/task_definitions/base/__init__.py,sha256=ZrFjiU_3JdfdIchWDVi-8WC1hCwv4Jvkwb5JfTyKs7M,2045
 karrio/server/events/task_definitions/base/archiving.py,sha256=HVUfgzTSsfa-o2u6N1VuyPopnVLdFRwvv-3ix5LjKHc,7270
+karrio/server/events/task_definitions/base/pickup.py,sha256=6QUcRnfEXGplUw2EW0yFJEtD-iCFPIb6B2_X9eiEAiQ,2164
 karrio/server/events/task_definitions/base/tracking.py,sha256=z5ja6lOjNMBtj5nu2TlKJxgnCelL58vxR5kpyDoUays,7179
 karrio/server/events/task_definitions/base/webhook.py,sha256=QNRq3xhLWQEbrs3zSy6Sa0AXUPhWE7YenKpPzZoFwL0,3616
 karrio/server/events/tests/__init__.py,sha256=5szv9hDvu0R0jtm3XWktY19rCaE8bZ2LdjRm4oJ0pYA,220
@@ -39,7 +40,7 @@ karrio/server/graph/schemas/events/__init__.py,sha256=Yg1rWew5DgSb_OnLy8n7qqwPLf
 karrio/server/graph/schemas/events/inputs.py,sha256=Mgy9qCUrbL-sMI5dNXsnbW8K5_PnGKM13brzZrc5OWk,1526
 karrio/server/graph/schemas/events/mutations.py,sha256=QDng4EXOBCBDVPuO4hxxRteQ_UfUxWUbjtHOk24X4LQ,1752
 karrio/server/graph/schemas/events/types.py,sha256=TPlrDwQV4LZXu-1t4gFl_eYayU39THmgYT3uv7VXnnw,2759
-karrio_server_events-2026.1.3.dist-info/METADATA,sha256=E-ltZ-s1lGP1ZZfzKHx-k0NOuwuMcqCQ7jUfArr3Iys,701
-karrio_server_events-2026.1.3.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-karrio_server_events-2026.1.3.dist-info/top_level.txt,sha256=D1D7x8R3cTfjF_15mfiO7wCQ5QMtuM4x8GaPr7z5i78,12
-karrio_server_events-2026.1.3.dist-info/RECORD,,
+karrio_server_events-2026.1.5.dist-info/METADATA,sha256=0WXhlnbfFUUiQzme5efWxpbdOv0ZbkDmpNyDWAkbr6I,701
+karrio_server_events-2026.1.5.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+karrio_server_events-2026.1.5.dist-info/top_level.txt,sha256=D1D7x8R3cTfjF_15mfiO7wCQ5QMtuM4x8GaPr7z5i78,12
+karrio_server_events-2026.1.5.dist-info/RECORD,,