kp-schema-sdk

kp Schema Registry — Shared Python enums and Pydantic v2 event models for all kp domain events across 20 modules (134 events).

Installation

pip install kp-schema-sdk==1.0.0

Always pin to an exact version. Do not use >= or ~= — this is a contract package.

Requirements

• Python ≥ 3.10
• pydantic ≥ 2.0.0

Usage

from kp_schema.generated.models import OrderCreatedEvent, BuyerBehaviorRecordedEvent
from kp_schema.shared_enums import OrderStatus, VendorStatus

# Validate an inbound event
raw = {
    "eventType": "order.created.v1",
    "correlationId": "req-abc-123",
    "timestamp": "2026-05-25T10:00:00Z",
    "payload": {
        "orderId": "order-xyz",
        "userId": "user-abc",
        "storeIds": ["store-1"],
        "totalKobo": 25000,
        "itemCount": 2,
        "isQrOrder": False,
        "checkoutSessionId": "chk-def",
    }
}
event = OrderCreatedEvent(**raw)
print(event.payload.order_id)   # "order-xyz"
print(event.payload.total_kobo) # 25000

# Use enums
status = OrderStatus.PENDING
assert status == "PENDING"  # str enum

Top-level import (convenience)

# Import everything from the top-level package
from kp_schema import OrderCreatedEvent, OrderStatus

Available Exports

kp_schema.shared_enums

All Prisma enums as Python str, Enum subclasses (JSON-safe serialization):

• OrderStatus — PENDING, CONFIRMED, PREPARING, READY_FOR_PICKUP, OUT_FOR_DELIVERY, COMPLETED, CANCELLED, FAILED, REFUNDED
• VendorStatus — PENDING, ACTIVE, SUSPENDED, REJECTED
• UserRole — BUYER, VENDOR, ADMIN, SUPER_ADMIN, SUPPORT
• ProductStatus — DRAFT, ACTIVE, ARCHIVED
• DeliveryStatus — PENDING, ASSIGNED, PICKED_UP, IN_TRANSIT, DELIVERED, FAILED, RETURNED
• NotificationChannel — PUSH, IN_APP, EMAIL, SMS
• 20+ additional enums — see kp_schema/shared_enums/__init__.py

kp_schema.generated.models

Pydantic v2 models with Field(alias="camelCase") + populate_by_name: True:

Union Types

from kp_schema.generated.models import AnyOrderEvent, AnyInventoryEvent, AnyIntelligenceEvent

Field Naming Convention

All models use camelCase JSON aliases with snake_case Python attributes:

event = OrderCreatedEvent(**json_data)
event.payload.order_id         # snake_case Python access
event.payload.model_dump(by_alias=True)["orderId"]  # camelCase JSON output

Version Policy

This package follows the kp Schema Registry semver rules:

• MAJOR — breaking change (field removed, type changed, event removed)
• MINOR — additive change (new event, new optional field)
• PATCH — editorial (description updates, constraint relaxation)

Source

Generated from: contracts/events/ in kp-schema-registry

Do not edit generated files directly — raise a PR in the schema registry instead.