openreplay/api/schemas/schemas.py
Kraiem Taha Yassine 82d2023019
Dev (#2292)
* refactor(chalice): upgraded dependencies

* refactor(chalice): upgraded dependencies
feat(chalice): support heatmaps

* feat(chalice): support table-of-issues showing user-count

* feat(chalice): support table-of-browsers showing user-count

* feat(chalice): support table-of-devices showing user-count

* feat(chalice): support table-of-URLs showing user-count
2024-06-21 17:09:59 +02:00

1632 lines
55 KiB
Python

from typing import Annotated, Any
from typing import Optional, List, Union, Literal
from pydantic import Field, EmailStr, HttpUrl, SecretStr, AnyHttpUrl, validator
from pydantic import field_validator, model_validator, computed_field
from chalicelib.utils.TimeUTC import TimeUTC
from .overrides import BaseModel, Enum, ORUnion
from .transformers_validators import transform_email, remove_whitespace, remove_duplicate_values, single_to_list, \
force_is_event, NAME_PATTERN, int_to_string
from pydantic.functional_validators import BeforeValidator
def transform_old_filter_type(cls, values):
if values.get("type") is None:
return values
values["type"] = {
# filters
"USEROS": FilterType.user_os.value,
"USERBROWSER": FilterType.user_browser.value,
"USERDEVICE": FilterType.user_device.value,
"USERCOUNTRY": FilterType.user_country.value,
"USERID": FilterType.user_id.value,
"USERANONYMOUSID": FilterType.user_anonymous_id.value,
"REFERRER": FilterType.referrer.value,
"REVID": FilterType.rev_id.value,
"USEROS_IOS": FilterType.user_os_mobile.value,
"USERDEVICE_IOS": FilterType.user_device_mobile.value,
"USERCOUNTRY_IOS": FilterType.user_country_mobile.value,
"USERID_IOS": FilterType.user_id_mobile.value,
"USERANONYMOUSID_IOS": FilterType.user_anonymous_id_mobile.value,
"REVID_IOS": FilterType.rev_id_mobile.value,
"DURATION": FilterType.duration.value,
"PLATFORM": FilterType.platform.value,
"METADATA": FilterType.metadata.value,
"ISSUE": FilterType.issue.value,
"EVENTS_COUNT": FilterType.events_count.value,
"UTM_SOURCE": FilterType.utm_source.value,
"UTM_MEDIUM": FilterType.utm_medium.value,
"UTM_CAMPAIGN": FilterType.utm_campaign.value,
# events:
"CLICK": EventType.click.value,
"INPUT": EventType.input.value,
"LOCATION": EventType.location.value,
"CUSTOM": EventType.custom.value,
"REQUEST": EventType.request.value,
"FETCH": EventType.request_details.value,
"GRAPHQL": EventType.graphql.value,
"STATEACTION": EventType.state_action.value,
"ERROR": EventType.error.value,
"CLICK_MOBILE": EventType.click_mobile.value,
"INPUT_MOBILE": EventType.input_mobile.value,
"VIEW_MOBILE": EventType.view_mobile.value,
"CUSTOM_MOBILE": EventType.custom_mobile.value,
"REQUEST_MOBILE": EventType.request_mobile.value,
"ERROR_MOBILE": EventType.error_mobile.value,
"DOM_COMPLETE": PerformanceEventType.location_dom_complete.value,
"LARGEST_CONTENTFUL_PAINT_TIME": PerformanceEventType.location_largest_contentful_paint_time.value,
"TTFB": PerformanceEventType.location_ttfb.value,
"AVG_CPU_LOAD": PerformanceEventType.location_avg_cpu_load.value,
"AVG_MEMORY_USAGE": PerformanceEventType.location_avg_memory_usage.value,
"FETCH_FAILED": PerformanceEventType.fetch_failed.value,
}.get(values["type"], values["type"])
return values
class _GRecaptcha(BaseModel):
g_recaptcha_response: Optional[str] = Field(default=None, alias='g-recaptcha-response')
class UserLoginSchema(_GRecaptcha):
email: EmailStr = Field(...)
password: SecretStr = Field(...)
_transform_email = field_validator('email', mode='before')(transform_email)
class UserSignupSchema(UserLoginSchema):
fullname: str = Field(..., min_length=1, pattern=NAME_PATTERN)
organizationName: str = Field(..., min_length=1, pattern=NAME_PATTERN)
_transform_fullname = field_validator('fullname', mode='before')(remove_whitespace)
_transform_organizationName = field_validator('organizationName', mode='before')(remove_whitespace)
class EditAccountSchema(BaseModel):
name: Optional[str] = Field(default=None, pattern=NAME_PATTERN)
tenantName: Optional[str] = Field(default=None, pattern=NAME_PATTERN)
opt_out: Optional[bool] = Field(default=None)
_transform_name = field_validator('name', mode='before')(remove_whitespace)
_transform_tenantName = field_validator('tenantName', mode='before')(remove_whitespace)
class ForgetPasswordPayloadSchema(_GRecaptcha):
email: EmailStr = Field(...)
_transform_email = field_validator('email', mode='before')(transform_email)
class EditUserPasswordSchema(BaseModel):
old_password: SecretStr = Field(...)
new_password: SecretStr = Field(...)
class CreateProjectSchema(BaseModel):
name: str = Field(default="my first project", pattern=NAME_PATTERN)
platform: Literal["web", "ios"] = Field(default="web")
_transform_name = field_validator('name', mode='before')(remove_whitespace)
class CurrentProjectContext(BaseModel):
project_id: int = Field(..., gt=0)
project_key: str = Field(...)
name: str = Field(...)
platform: Literal["web", "ios"] = Field(...)
class CurrentAPIContext(BaseModel):
tenant_id: int = Field(...)
project: Optional[CurrentProjectContext] = Field(default=None)
class CurrentContext(CurrentAPIContext):
user_id: int = Field(...)
email: EmailStr = Field(...)
role: str = Field(...)
_transform_email = field_validator('email', mode='before')(transform_email)
@computed_field
@property
def is_owner(self) -> bool:
return self.role == "owner"
@computed_field
@property
def is_admin(self) -> bool:
return self.role == "admin"
@computed_field
@property
def is_member(self) -> bool:
return self.role == "member"
class AddCollaborationSchema(BaseModel):
name: str = Field(..., pattern=NAME_PATTERN)
url: HttpUrl = Field(...)
_transform_name = field_validator('name', mode='before')(remove_whitespace)
_transform_url = field_validator('url', mode='before')(remove_whitespace)
class EditCollaborationSchema(AddCollaborationSchema):
name: Optional[str] = Field(default=None, pattern=NAME_PATTERN)
class _TimedSchema(BaseModel):
startTimestamp: int = Field(default=None)
endTimestamp: int = Field(default=None)
@model_validator(mode='before')
def transform_time(cls, values):
if values.get("startTimestamp") is None and values.get("startDate") is not None:
values["startTimestamp"] = values["startDate"]
if values.get("endTimestamp") is None and values.get("endDate") is not None:
values["endTimestamp"] = values["endDate"]
return values
@model_validator(mode='after')
def __time_validator(cls, values):
if values.startTimestamp is not None:
assert 0 <= values.startTimestamp, "startTimestamp must be greater or equal to 0"
if values.endTimestamp is not None:
assert 0 <= values.endTimestamp, "endTimestamp must be greater or equal to 0"
if values.startTimestamp is not None and values.endTimestamp is not None:
assert values.startTimestamp <= values.endTimestamp, \
"endTimestamp must be greater or equal to startTimestamp"
return values
class NotificationsViewSchema(_TimedSchema):
ids: List[int] = Field(default=[])
startTimestamp: Optional[int] = Field(default=None)
endTimestamp: Optional[int] = Field(default=None)
class IssueTrackingIntegration(BaseModel):
token: str = Field(...)
class IssueTrackingGithubSchema(IssueTrackingIntegration):
pass
class IssueTrackingJiraSchema(IssueTrackingIntegration):
username: str = Field(...)
url: HttpUrl = Field(...)
@field_validator('url')
@classmethod
def transform_url(cls, v: HttpUrl):
return HttpUrl.build(scheme=v.scheme.lower(), host=v.host.lower())
class WebhookSchema(BaseModel):
webhook_id: Optional[int] = Field(default=None)
endpoint: AnyHttpUrl = Field(...)
auth_header: Optional[str] = Field(default=None)
name: str = Field(default="", max_length=100, pattern=NAME_PATTERN)
_transform_name = field_validator('name', mode='before')(remove_whitespace)
class CreateMemberSchema(BaseModel):
user_id: Optional[int] = Field(default=None)
name: str = Field(...)
email: EmailStr = Field(...)
admin: bool = Field(default=False)
_transform_email = field_validator('email', mode='before')(transform_email)
_transform_name = field_validator('name', mode='before')(remove_whitespace)
class EditMemberSchema(BaseModel):
name: str = Field(..., pattern=NAME_PATTERN)
email: EmailStr = Field(...)
admin: bool = Field(default=False)
_transform_email = field_validator('email', mode='before')(transform_email)
_transform_name = field_validator('name', mode='before')(remove_whitespace)
class EditPasswordByInvitationSchema(BaseModel):
invitation: str = Field(...)
passphrase: str = Field(..., alias="pass")
password: SecretStr = Field(...)
class AssignmentSchema(BaseModel):
assignee: str = Field(...)
description: str = Field(...)
title: str = Field(...)
issue_type: str = Field(...)
_transform_title = field_validator('title', mode='before')(remove_whitespace)
class CommentAssignmentSchema(BaseModel):
message: str = Field(...)
class IntegrationNotificationSchema(BaseModel):
comment: Optional[str] = Field(default=None)
class GdprSchema(BaseModel):
maskEmails: bool = Field(...)
sampleRate: int = Field(...)
maskNumbers: bool = Field(...)
defaultInputMode: str = Field(...)
class SampleRateSchema(BaseModel):
rate: int = Field(..., ge=0, le=100)
capture_all: bool = Field(default=False)
class WeeklyReportConfigSchema(BaseModel):
weekly_report: bool = Field(default=True)
class IntegrationBase(BaseModel):
pass
class IntegrationSentrySchema(IntegrationBase):
project_slug: str = Field(...)
organization_slug: str = Field(...)
token: str = Field(...)
class IntegrationDatadogSchema(IntegrationBase):
api_key: str = Field(...)
application_key: str = Field(...)
class IntegartionStackdriverSchema(IntegrationBase):
service_account_credentials: str = Field(...)
log_name: str = Field(...)
class IntegrationNewrelicSchema(IntegrationBase):
application_id: str = Field(...)
x_query_key: str = Field(...)
region: bool = Field(default=False)
class IntegrationRollbarSchema(IntegrationBase):
access_token: str = Field(...)
class IntegrationBugsnagBasicSchema(IntegrationBase):
authorization_token: str = Field(...)
class IntegrationBugsnagSchema(IntegrationBugsnagBasicSchema):
bugsnag_project_id: str = Field(...)
class IntegrationCloudwatchBasicSchema(IntegrationBase):
aws_access_key_id: str = Field(...)
aws_secret_access_key: str = Field(...)
region: str = Field(...)
class IntegrationCloudwatchSchema(IntegrationCloudwatchBasicSchema):
log_group_name: str = Field(...)
class IntegrationElasticsearchTestSchema(IntegrationBase):
host: str = Field(...)
port: int = Field(...)
api_key_id: str = Field(...)
api_key: str = Field(...)
class IntegrationElasticsearchSchema(IntegrationElasticsearchTestSchema):
indexes: str = Field(...)
class IntegrationSumologicSchema(IntegrationBase):
access_id: str = Field(...)
access_key: str = Field(...)
region: str = Field(...)
class MetadataSchema(BaseModel):
index: Optional[int] = Field(default=None)
key: str = Field(...)
_transform_key = field_validator('key', mode='before')(remove_whitespace)
class EmailPayloadSchema(BaseModel):
auth: str = Field(...)
email: EmailStr = Field(...)
link: str = Field(...)
message: str = Field(...)
_transform_email = field_validator('email', mode='before')(transform_email)
class MemberInvitationPayloadSchema(BaseModel):
auth: str = Field(...)
email: EmailStr = Field(...)
invitation_link: str = Field(...)
client_id: str = Field(...)
sender_name: str = Field(...)
_transform_email = field_validator('email', mode='before')(transform_email)
class _AlertMessageSchema(BaseModel):
type: str = Field(...)
value: str = Field(...)
_transform_value = field_validator('value', mode='before')(int_to_string)
class AlertDetectionType(str, Enum):
percent = "percent"
change = "change"
class _AlertOptionSchema(BaseModel):
message: List[_AlertMessageSchema] = Field([])
currentPeriod: Literal[15, 30, 60, 120, 240, 1440] = Field(...)
previousPeriod: Literal[15, 30, 60, 120, 240, 1440] = Field(default=15)
lastNotification: Optional[int] = Field(default=None)
renotifyInterval: Optional[int] = Field(default=720)
class AlertColumn(str, Enum):
performance__dom_content_loaded__average = "performance.dom_content_loaded.average"
performance__first_meaningful_paint__average = "performance.first_meaningful_paint.average"
performance__page_load_time__average = "performance.page_load_time.average"
performance__dom_build_time__average = "performance.dom_build_time.average"
performance__speed_index__average = "performance.speed_index.average"
performance__page_response_time__average = "performance.page_response_time.average"
performance__ttfb__average = "performance.ttfb.average"
performance__time_to_render__average = "performance.time_to_render.average"
performance__image_load_time__average = "performance.image_load_time.average"
performance__request_load_time__average = "performance.request_load_time.average"
resources__load_time__average = "resources.load_time.average"
resources__missing__count = "resources.missing.count"
errors__4xx_5xx__count = "errors.4xx_5xx.count"
errors__4xx__count = "errors.4xx.count"
errors__5xx__count = "errors.5xx.count"
errors__javascript__impacted_sessions__count = "errors.javascript.impacted_sessions.count"
performance__crashes__count = "performance.crashes.count"
errors__javascript__count = "errors.javascript.count"
errors__backend__count = "errors.backend.count"
custom = "CUSTOM"
class MathOperator(str, Enum):
_equal = "="
_less = "<"
_greater = ">"
_less_eq = "<="
_greater_eq = ">="
class _AlertQuerySchema(BaseModel):
left: Union[AlertColumn, int] = Field(...)
right: float = Field(...)
operator: MathOperator = Field(...)
class AlertDetectionMethod(str, Enum):
threshold = "threshold"
change = "change"
class AlertSchema(BaseModel):
name: str = Field(..., pattern=NAME_PATTERN)
detection_method: AlertDetectionMethod = Field(...)
change: Optional[AlertDetectionType] = Field(default=AlertDetectionType.change)
description: Optional[str] = Field(default=None)
options: _AlertOptionSchema = Field(...)
query: _AlertQuerySchema = Field(...)
series_id: Optional[int] = Field(default=None, doc_hidden=True)
@model_validator(mode="after")
def transform_alert(cls, values):
values.series_id = None
if isinstance(values.query.left, int):
values.series_id = values.query.left
values.query.left = AlertColumn.custom
return values
class SourcemapUploadPayloadSchema(BaseModel):
urls: List[str] = Field(..., alias="URL")
class ErrorSource(str, Enum):
js_exception = "js_exception"
bugsnag = "bugsnag"
cloudwatch = "cloudwatch"
datadog = "datadog"
newrelic = "newrelic"
rollbar = "rollbar"
sentry = "sentry"
stackdriver = "stackdriver"
sumologic = "sumologic"
class EventType(str, Enum):
click = "click"
input = "input"
location = "location"
custom = "custom"
request = "request"
request_details = "fetch"
graphql = "graphql"
state_action = "stateAction"
error = "error"
tag = "tag"
click_mobile = "tapIos"
input_mobile = "inputIos"
view_mobile = "viewIos"
custom_mobile = "customIos"
request_mobile = "requestIos"
error_mobile = "errorIos"
swipe_mobile = "swipeIos"
class PerformanceEventType(str, Enum):
location_dom_complete = "domComplete"
location_largest_contentful_paint_time = "largestContentfulPaintTime"
location_ttfb = "ttfb"
location_avg_cpu_load = "avgCpuLoad"
location_avg_memory_usage = "avgMemoryUsage"
fetch_failed = "fetchFailed"
# fetch_duration = "FETCH_DURATION"
class FilterType(str, Enum):
user_os = "userOs"
user_browser = "userBrowser"
user_device = "userDevice"
user_country = "userCountry"
user_city = "userCity"
user_state = "userState"
user_id = "userId"
user_anonymous_id = "userAnonymousId"
referrer = "referrer"
rev_id = "revId"
# IOS
user_os_mobile = "userOsIos"
user_device_mobile = "userDeviceIos"
user_country_mobile = "userCountryIos"
user_id_mobile = "userIdIos"
user_anonymous_id_mobile = "userAnonymousIdIos"
rev_id_mobile = "revIdIos"
#
duration = "duration"
platform = "platform"
metadata = "metadata"
issue = "issue"
events_count = "eventsCount"
utm_source = "utmSource"
utm_medium = "utmMedium"
utm_campaign = "utmCampaign"
# Mobile conditions
thermal_state = "thermalState"
main_thread_cpu = "mainThreadCPU"
view_component = "viewComponent"
log_event = "logEvent"
click_event = "clickEvent"
memory_usage = "memoryUsage"
class SearchEventOperator(str, Enum):
_is = "is"
_is_any = "isAny"
_on = "on"
_on_any = "onAny"
_is_not = "isNot"
_is_undefined = "isUndefined"
_not_on = "notOn"
_contains = "contains"
_not_contains = "notContains"
_starts_with = "startsWith"
_ends_with = "endsWith"
class ClickEventExtraOperator(str, Enum):
_on_selector = "onSelector"
class PlatformType(str, Enum):
mobile = "mobile"
desktop = "desktop"
tablet = "tablet"
class SearchEventOrder(str, Enum):
_then = "then"
_or = "or"
_and = "and"
class IssueType(str, Enum):
click_rage = 'click_rage'
dead_click = 'dead_click'
excessive_scrolling = 'excessive_scrolling'
bad_request = 'bad_request'
missing_resource = 'missing_resource'
memory = 'memory'
cpu = 'cpu'
slow_resource = 'slow_resource'
slow_page_load = 'slow_page_load'
crash = 'crash'
custom = 'custom'
js_exception = 'js_exception'
mouse_thrashing = 'mouse_thrashing'
# IOS
tap_rage = 'tap_rage'
class MetricFormatType(str, Enum):
session_count = 'sessionCount'
class MetricExtendedFormatType(str, Enum):
session_count = 'sessionCount'
user_count = 'userCount'
class HttpMethod(str, Enum):
_get = 'GET'
_head = 'HEAD'
_post = 'POST'
_put = 'PUT'
_delete = 'DELETE'
_connect = 'CONNECT'
_option = 'OPTIONS'
_trace = 'TRACE'
_patch = 'PATCH'
class FetchFilterType(str, Enum):
_url = "fetchUrl"
_status_code = "fetchStatusCode"
_method = "fetchMethod"
_duration = "fetchDuration"
_request_body = "fetchRequestBody"
_response_body = "fetchResponseBody"
class GraphqlFilterType(str, Enum):
_name = "graphqlName"
_method = "graphqlMethod"
_request_body = "graphqlRequestBody"
_response_body = "graphqlResponseBody"
class RequestGraphqlFilterSchema(BaseModel):
type: Union[FetchFilterType, GraphqlFilterType] = Field(...)
value: List[Union[int, str]] = Field(...)
operator: Union[SearchEventOperator, MathOperator] = Field(...)
class SessionSearchEventSchema2(BaseModel):
is_event: Literal[True] = True
value: List[Union[str, int]] = Field(...)
type: Union[EventType, PerformanceEventType] = Field(...)
operator: Union[SearchEventOperator, ClickEventExtraOperator] = Field(...)
source: Optional[List[Union[ErrorSource, int, str]]] = Field(default=None)
sourceOperator: Optional[MathOperator] = Field(default=None)
filters: Optional[List[RequestGraphqlFilterSchema]] = Field(default=[])
_remove_duplicate_values = field_validator('value', mode='before')(remove_duplicate_values)
_single_to_list_values = field_validator('value', mode='before')(single_to_list)
_transform = model_validator(mode='before')(transform_old_filter_type)
@model_validator(mode='after')
def event_validator(cls, values):
if isinstance(values.type, PerformanceEventType):
if values.type == PerformanceEventType.fetch_failed:
return values
# assert values.get("source") is not None, "source should not be null for PerformanceEventType"
# assert isinstance(values["source"], list) and len(values["source"]) > 0, \
# "source should not be empty for PerformanceEventType"
assert values.sourceOperator is not None, \
"sourceOperator should not be null for PerformanceEventType"
assert "source" in values, f"source is required for {values.type}"
assert isinstance(values.source, list), f"source of type list is required for {values.type}"
for c in values["source"]:
assert isinstance(c, int), f"source value should be of type int for {values.type}"
elif values.type == EventType.error and values.source is None:
values.source = [ErrorSource.js_exception]
elif values.type == EventType.request_details:
assert isinstance(values.filters, List) and len(values.filters) > 0, \
f"filters should be defined for {EventType.request_details}"
elif values.type == EventType.graphql:
assert isinstance(values.filters, List) and len(values.filters) > 0, \
f"filters should be defined for {EventType.graphql}"
if isinstance(values.operator, ClickEventExtraOperator):
assert values.type == EventType.click, \
f"operator:{values.operator} is only available for event-type: {EventType.click}"
return values
class SessionSearchFilterSchema(BaseModel):
is_event: Literal[False] = False
value: List[Union[IssueType, PlatformType, int, str]] = Field(default=[])
type: FilterType = Field(...)
operator: Union[SearchEventOperator, MathOperator] = Field(...)
source: Optional[Union[ErrorSource, str]] = Field(default=None)
_remove_duplicate_values = field_validator('value', mode='before')(remove_duplicate_values)
_transform = model_validator(mode='before')(transform_old_filter_type)
_single_to_list_values = field_validator('value', mode='before')(single_to_list)
@model_validator(mode='before')
def _transform_data(cls, values):
if values.get("source") is not None:
if isinstance(values["source"], list):
if len(values["source"]) == 0:
values["source"] = None
elif len(values["source"]) == 1:
values["source"] = values["source"][0]
else:
raise ValueError(f"Unsupported multi-values source")
return values
@model_validator(mode='after')
def filter_validator(cls, values):
if values.type == FilterType.metadata:
assert values.source is not None and len(values.source) > 0, \
"must specify a valid 'source' for metadata filter"
elif values.type == FilterType.issue:
for v in values.value:
if IssueType.has_value(v):
v = IssueType(v)
else:
raise ValueError(f"value should be of type IssueType for {values.type} filter")
elif values.type == FilterType.platform:
for v in values.value:
if PlatformType.has_value(v):
v = PlatformType(v)
else:
raise ValueError(f"value should be of type PlatformType for {values.type} filter")
elif values.type == FilterType.events_count:
if values.operator in MathOperator.has_value(values.operator):
values.operator = MathOperator(values.operator)
else:
raise ValueError(f"operator should be of type MathOperator for {values.type} filter")
for v in values.value:
assert isinstance(v, int), f"value should be of type int for {values.type} filter"
else:
if SearchEventOperator.has_value(values.operator):
values.operator = SearchEventOperator(values.operator)
else:
raise ValueError(f"operator should be of type SearchEventOperator for {values.type} filter")
return values
class _PaginatedSchema(BaseModel):
limit: int = Field(default=200, gt=0, le=200)
page: int = Field(default=1, gt=0)
class SortOrderType(str, Enum):
asc = "ASC"
desc = "DESC"
def add_missing_is_event(values: dict):
if values.get("isEvent") is None:
values["isEvent"] = (EventType.has_value(values["type"])
or PerformanceEventType.has_value(values["type"])
or ProductAnalyticsSelectedEventType.has_value(values["type"]))
return values
# this type is created to allow mixing events&filters and specifying a discriminator
GroupedFilterType = Annotated[Union[SessionSearchFilterSchema, SessionSearchEventSchema2], \
Field(discriminator='is_event'), BeforeValidator(add_missing_is_event)]
class SessionsSearchPayloadSchema(_TimedSchema, _PaginatedSchema):
events: List[SessionSearchEventSchema2] = Field(default=[], doc_hidden=True)
filters: List[GroupedFilterType] = Field(default=[])
sort: str = Field(default="startTs")
order: SortOrderType = Field(default=SortOrderType.desc)
events_order: Optional[SearchEventOrder] = Field(default=SearchEventOrder._then)
group_by_user: bool = Field(default=False)
bookmarked: bool = Field(default=False)
@model_validator(mode="before")
def transform_order(cls, values):
if values.get("sort") is None:
values["sort"] = "startTs"
if values.get("order") is None:
values["order"] = SortOrderType.desc
else:
values["order"] = values["order"].upper()
return values
@model_validator(mode="before")
def add_missing_attributes(cls, values):
# in case the old search payload was passed
if len(values.get("events", [])) > 0:
for v in values["events"]:
v["isEvent"] = True
# for v in values.get("filters", []):
# if v.get("isEvent") is None:
# v["isEvent"] = False
return values
@model_validator(mode="before")
def remove_wrong_filter_values(cls, values):
for f in values.get("filters", []):
vals = []
for v in f.get("value", []):
if v is not None:
vals.append(v)
f["value"] = vals
return values
@model_validator(mode="after")
def split_filters_events(cls, values):
n_filters = []
n_events = []
for v in values.filters:
if v.is_event:
n_events.append(v)
else:
n_filters.append(v)
values.events = n_events
values.filters = n_filters
return values
@field_validator("filters", mode="after")
def merge_identical_filters(cls, values):
# ignore 'issue' type as it could be used for step-filters and tab-filters at the same time
i = 0
while i < len(values):
if values[i].is_event or values[i].type == FilterType.issue:
if values[i].type == FilterType.issue:
values[i] = remove_duplicate_values(values[i])
i += 1
continue
j = i + 1
while j < len(values):
if values[i].type == values[j].type \
and values[i].operator == values[j].operator \
and (values[i].type != FilterType.metadata or values[i].source == values[j].source):
values[i].value += values[j].value
del values[j]
else:
j += 1
values[i] = remove_duplicate_values(values[i])
i += 1
return values
class ErrorStatus(str, Enum):
all = 'all'
unresolved = 'unresolved'
resolved = 'resolved'
ignored = 'ignored'
class ErrorSort(str, Enum):
occurrence = 'occurrence'
users_count = 'users'
sessions_count = 'sessions'
class SearchErrorsSchema(SessionsSearchPayloadSchema):
sort: ErrorSort = Field(default=ErrorSort.occurrence)
density: Optional[int] = Field(default=7)
status: Optional[ErrorStatus] = Field(default=ErrorStatus.all)
query: Optional[str] = Field(default=None)
class ProductAnalyticsSelectedEventType(str, Enum):
click = EventType.click.value
input = EventType.input.value
location = EventType.location.value
custom_event = EventType.custom.value
class PathAnalysisSubFilterSchema(BaseModel):
is_event: Literal[True] = True
value: List[str] = Field(...)
type: ProductAnalyticsSelectedEventType = Field(...)
operator: Union[SearchEventOperator, ClickEventExtraOperator] = Field(...)
_remove_duplicate_values = field_validator('value', mode='before')(remove_duplicate_values)
@model_validator(mode="before")
def __force_is_event(cls, values):
values["isEvent"] = True
return values
class _ProductAnalyticsFilter(BaseModel):
is_event: Literal[False] = False
type: FilterType
operator: Union[SearchEventOperator, ClickEventExtraOperator, MathOperator] = Field(...)
value: List[Union[IssueType, PlatformType, int, str]] = Field(...)
source: Optional[str] = Field(default=None)
_remove_duplicate_values = field_validator('value', mode='before')(remove_duplicate_values)
class _ProductAnalyticsEventFilter(BaseModel):
is_event: Literal[True] = True
type: ProductAnalyticsSelectedEventType
operator: Union[SearchEventOperator, ClickEventExtraOperator, MathOperator] = Field(...)
# TODO: support session metadata filters
value: List[Union[IssueType, PlatformType, int, str]] = Field(...)
_remove_duplicate_values = field_validator('value', mode='before')(remove_duplicate_values)
# this type is created to allow mixing events&filters and specifying a discriminator for PathAnalysis series filter
ProductAnalyticsFilter = Annotated[Union[_ProductAnalyticsFilter, _ProductAnalyticsEventFilter], \
Field(discriminator='is_event')]
class PathAnalysisSchema(_TimedSchema, _PaginatedSchema):
density: int = Field(default=7)
filters: List[ProductAnalyticsFilter] = Field(default=[])
type: Optional[str] = Field(default=None)
_transform_filters = field_validator('filters', mode='before') \
(force_is_event(events_enum=[ProductAnalyticsSelectedEventType]))
class MobileSignPayloadSchema(BaseModel):
keys: List[str] = Field(...)
class CardSeriesFilterSchema(SearchErrorsSchema):
sort: Optional[str] = Field(default=None)
order: SortOrderType = Field(default=SortOrderType.desc)
group_by_user: Literal[False] = False
class CardSeriesSchema(BaseModel):
series_id: Optional[int] = Field(default=None)
name: Optional[str] = Field(default=None)
index: Optional[int] = Field(default=None)
filter: Optional[CardSeriesFilterSchema] = Field(default=None)
class MetricTimeseriesViewType(str, Enum):
line_chart = "lineChart"
progress = "progress"
area_chart = "areaChart"
class MetricTableViewType(str, Enum):
table = "table"
pie_chart = "pieChart"
class MetricOtherViewType(str, Enum):
other_chart = "chart"
list_chart = "list"
class MetricType(str, Enum):
timeseries = "timeseries"
table = "table"
funnel = "funnel"
errors = "errors"
performance = "performance"
resources = "resources"
web_vital = "webVitals"
pathAnalysis = "pathAnalysis"
retention = "retention"
stickiness = "stickiness"
click_map = "clickMap"
# click_map and heat_map are the same
heat_map = "heatMap"
insights = "insights"
class MetricOfErrors(str, Enum):
calls_errors = "callsErrors"
domains_errors_4xx = "domainsErrors4xx"
domains_errors_5xx = "domainsErrors5xx"
errors_per_domains = "errorsPerDomains"
errors_per_type = "errorsPerType"
impacted_sessions_by_js_errors = "impactedSessionsByJsErrors"
resources_by_party = "resourcesByParty"
class MetricOfPerformance(str, Enum):
cpu = "cpu"
crashes = "crashes"
fps = "fps"
impacted_sessions_by_slow_pages = "impactedSessionsBySlowPages"
memory_consumption = "memoryConsumption"
pages_dom_buildtime = "pagesDomBuildtime"
pages_response_time = "pagesResponseTime"
pages_response_time_distribution = "pagesResponseTimeDistribution"
resources_vs_visually_complete = "resourcesVsVisuallyComplete"
sessions_per_browser = "sessionsPerBrowser"
slowest_domains = "slowestDomains"
speed_location = "speedLocation"
time_to_render = "timeToRender"
class MetricOfResources(str, Enum):
missing_resources = "missingResources"
resources_count_by_type = "resourcesCountByType"
resources_loading_time = "resourcesLoadingTime"
resource_type_vs_response_end = "resourceTypeVsResponseEnd"
slowest_resources = "slowestResources"
class MetricOfWebVitals(str, Enum):
avg_cpu = "avgCpu"
avg_dom_content_loaded = "avgDomContentLoaded"
avg_dom_content_load_start = "avgDomContentLoadStart"
avg_first_contentful_pixel = "avgFirstContentfulPixel"
avg_first_paint = "avgFirstPaint"
avg_fps = "avgFps"
avg_image_load_time = "avgImageLoadTime"
avg_page_load_time = "avgPageLoadTime"
avg_pages_dom_buildtime = "avgPagesDomBuildtime"
avg_pages_response_time = "avgPagesResponseTime"
avg_request_load_time = "avgRequestLoadTime"
avg_response_time = "avgResponseTime"
avg_session_duration = "avgSessionDuration"
avg_till_first_byte = "avgTillFirstByte"
avg_time_to_interactive = "avgTimeToInteractive"
avg_time_to_render = "avgTimeToRender"
avg_used_js_heap_size = "avgUsedJsHeapSize"
avg_visited_pages = "avgVisitedPages"
count_requests = "countRequests"
count_sessions = "countSessions"
count_users = "countUsers"
class MetricOfTable(str, Enum):
user_os = FilterType.user_os.value
user_browser = FilterType.user_browser.value
user_device = FilterType.user_device.value
user_country = FilterType.user_country.value
# user_city = FilterType.user_city.value
# user_state = FilterType.user_state.value
user_id = FilterType.user_id.value
issues = FilterType.issue.value
visited_url = "location"
sessions = "sessions"
errors = "jsException"
class MetricOfTimeseries(str, Enum):
session_count = "sessionCount"
user_count = "userCount"
class MetricOfFunnels(str, Enum):
session_count = MetricOfTimeseries.session_count.value
class MetricOfClickMap(str, Enum):
click_map_url = "clickMapUrl"
class MetricOfPathAnalysis(str, Enum):
session_count = MetricOfTimeseries.session_count.value
# class CardSessionsSchema(SessionsSearchPayloadSchema):
class CardSessionsSchema(_TimedSchema, _PaginatedSchema):
startTimestamp: int = Field(default=TimeUTC.now(-7))
endTimestamp: int = Field(defautl=TimeUTC.now())
density: int = Field(default=7, ge=1, le=200)
series: List[CardSeriesSchema] = Field(default=[])
# events: List[SessionSearchEventSchema2] = Field(default=[], doc_hidden=True)
filters: List[GroupedFilterType] = Field(default=[])
# Used mainly for PathAnalysis, and could be used by other cards
hide_excess: Optional[bool] = Field(default=False, description="Hide extra values")
_transform_filters = field_validator('filters', mode='before') \
(force_is_event(events_enum=[EventType, PerformanceEventType]))
@model_validator(mode="before")
def remove_wrong_filter_values(cls, values):
for f in values.get("filters", []):
vals = []
for v in f.get("value", []):
if v is not None:
vals.append(v)
f["value"] = vals
return values
@model_validator(mode="before")
def __enforce_default(cls, values):
if values.get("startTimestamp") is None:
values["startTimestamp"] = TimeUTC.now(-7)
if values.get("endTimestamp") is None:
values["endTimestamp"] = TimeUTC.now()
return values
@model_validator(mode="after")
def __enforce_default_after(cls, values):
for s in values.series:
if s.filter is not None:
s.filter.limit = values.limit
s.filter.page = values.page
s.filter.startTimestamp = values.startTimestamp
s.filter.endTimestamp = values.endTimestamp
return values
class CardConfigSchema(BaseModel):
col: Optional[int] = Field(default=None)
row: Optional[int] = Field(default=2)
position: Optional[int] = Field(default=0)
class __CardSchema(CardSessionsSchema):
name: Optional[str] = Field(default=None)
is_public: bool = Field(default=True)
default_config: CardConfigSchema = Field(default=CardConfigSchema(), alias="config")
thumbnail: Optional[str] = Field(default=None)
metric_format: Optional[MetricFormatType] = Field(default=None)
view_type: Any
metric_type: MetricType = Field(...)
metric_of: Any
metric_value: List[IssueType] = Field(default=[])
@computed_field
@property
def is_predefined(self) -> bool:
return self.metric_type in [MetricType.errors, MetricType.performance,
MetricType.resources, MetricType.web_vital]
# TODO: finish the reset of these conditions
# @model_validator(mode='after')
# def __validator(cls, values):
# if values.metric_type == MetricType.click_map:
# # assert isinstance(values.metric_of, MetricOfClickMap), \
# # f"metricOf must be of type {MetricOfClickMap} for metricType:{MetricType.click_map}"
# for s in values.series:
# for f in s.filter.events:
# assert f.type == EventType.location, f"only events of type:{EventType.location} are allowed for metricOf:{MetricType.click_map}"
# return values
class CardTimeSeries(__CardSchema):
metric_type: Literal[MetricType.timeseries]
metric_of: MetricOfTimeseries = Field(default=MetricOfTimeseries.session_count)
view_type: MetricTimeseriesViewType
@model_validator(mode="before")
def __enforce_default(cls, values):
values["metricValue"] = []
return values
@model_validator(mode="after")
def __transform(cls, values):
values.metric_of = MetricOfTimeseries(values.metric_of)
return values
class CardTable(__CardSchema):
metric_type: Literal[MetricType.table]
metric_of: MetricOfTable = Field(default=MetricOfTable.user_id)
view_type: MetricTableViewType = Field(...)
metric_format: MetricExtendedFormatType = Field(default=MetricExtendedFormatType.session_count)
@model_validator(mode="before")
def __enforce_default(cls, values):
if values.get("metricOf") is not None and values.get("metricOf") != MetricOfTable.issues:
values["metricValue"] = []
return values
@model_validator(mode="after")
def __transform(cls, values):
values.metric_of = MetricOfTable(values.metric_of)
return values
@model_validator(mode="after")
def __validator(cls, values):
if values.metric_of not in (MetricOfTable.issues, MetricOfTable.user_browser,
MetricOfTable.user_device, MetricOfTable.user_country,
MetricOfTable.visited_url):
assert values.metric_format == MetricExtendedFormatType.session_count, \
f'metricFormat:{MetricExtendedFormatType.user_count.value} is not supported for this metricOf'
return values
class CardFunnel(__CardSchema):
metric_type: Literal[MetricType.funnel]
metric_of: MetricOfFunnels = Field(default=MetricOfFunnels.session_count)
view_type: MetricOtherViewType = Field(...)
@model_validator(mode="before")
def __enforce_default(cls, values):
values["metricOf"] = MetricOfFunnels.session_count
values["viewType"] = MetricOtherViewType.other_chart
if values.get("series") is not None and len(values["series"]) > 0:
values["series"] = [values["series"][0]]
return values
@model_validator(mode="after")
def __transform(cls, values):
values.metric_of = MetricOfTimeseries(values.metric_of)
return values
class CardErrors(__CardSchema):
metric_type: Literal[MetricType.errors]
metric_of: MetricOfErrors = Field(default=MetricOfErrors.impacted_sessions_by_js_errors)
view_type: MetricOtherViewType = Field(...)
@model_validator(mode="before")
def __enforce_default(cls, values):
values["series"] = []
return values
@model_validator(mode="after")
def __transform(cls, values):
values.metric_of = MetricOfErrors(values.metric_of)
return values
class CardPerformance(__CardSchema):
metric_type: Literal[MetricType.performance]
metric_of: MetricOfPerformance = Field(default=MetricOfPerformance.cpu)
view_type: MetricOtherViewType = Field(...)
@model_validator(mode="before")
def __enforce_default(cls, values):
values["series"] = []
return values
@model_validator(mode="after")
def __transform(cls, values):
values.metric_of = MetricOfPerformance(values.metric_of)
return values
class CardResources(__CardSchema):
metric_type: Literal[MetricType.resources]
metric_of: MetricOfResources = Field(default=MetricOfResources.missing_resources)
view_type: MetricOtherViewType = Field(...)
@model_validator(mode="before")
def __enforce_default(cls, values):
values["series"] = []
return values
@model_validator(mode="after")
def __transform(cls, values):
values.metric_of = MetricOfResources(values.metric_of)
return values
class CardWebVital(__CardSchema):
metric_type: Literal[MetricType.web_vital]
metric_of: MetricOfWebVitals = Field(default=MetricOfWebVitals.avg_cpu)
view_type: MetricOtherViewType = Field(...)
@model_validator(mode="before")
def __enforce_default(cls, values):
values["series"] = []
return values
@model_validator(mode="after")
def __transform(cls, values):
values.metric_of = MetricOfWebVitals(values.metric_of)
return values
class CardClickMap(__CardSchema):
metric_type: Literal[MetricType.click_map]
metric_of: MetricOfClickMap = Field(default=MetricOfClickMap.click_map_url)
view_type: MetricOtherViewType = Field(...)
@model_validator(mode="before")
def __enforce_default(cls, values):
return values
@model_validator(mode="after")
def __transform(cls, values):
values.metric_of = MetricOfClickMap(values.metric_of)
return values
class MetricOfInsights(str, Enum):
issue_categories = "issueCategories"
class CardInsights(__CardSchema):
metric_type: Literal[MetricType.insights]
metric_of: MetricOfInsights = Field(default=MetricOfInsights.issue_categories)
view_type: MetricOtherViewType = Field(...)
@model_validator(mode="before")
def __enforce_default(cls, values):
values["view_type"] = MetricOtherViewType.list_chart
return values
@model_validator(mode="after")
def __transform(cls, values):
values.metric_of = MetricOfInsights(values.metric_of)
return values
@model_validator(mode='after')
def restrictions(cls, values):
raise ValueError(f"metricType:{MetricType.insights} not supported yet.")
class CardPathAnalysisSeriesSchema(CardSeriesSchema):
name: Optional[str] = Field(default=None)
filter: PathAnalysisSchema = Field(...)
density: int = Field(default=4, ge=2, le=10)
@model_validator(mode="before")
def __enforce_default(cls, values):
if values.get("filter") is None and values.get("startTimestamp") and values.get("endTimestamp"):
values["filter"] = PathAnalysisSchema(startTimestamp=values["startTimestamp"],
endTimestamp=values["endTimestamp"],
density=values["density"])
return values
class CardPathAnalysis(__CardSchema):
metric_type: Literal[MetricType.pathAnalysis]
metric_of: MetricOfPathAnalysis = Field(default=MetricOfPathAnalysis.session_count)
view_type: MetricOtherViewType = Field(...)
metric_value: List[ProductAnalyticsSelectedEventType] = Field(default=[])
density: int = Field(default=4, ge=2, le=10)
start_type: Literal["start", "end"] = Field(default="start")
start_point: List[PathAnalysisSubFilterSchema] = Field(default=[])
excludes: List[PathAnalysisSubFilterSchema] = Field(default=[])
series: List[CardPathAnalysisSeriesSchema] = Field(default=[])
@model_validator(mode="before")
def __enforce_default(cls, values):
values["viewType"] = MetricOtherViewType.other_chart.value
if values.get("series") is not None and len(values["series"]) > 0:
values["series"] = [values["series"][0]]
return values
@model_validator(mode="after")
def __clean_start_point_and_enforce_metric_value(cls, values):
start_point = []
for s in values.start_point:
if len(s.value) == 0:
continue
start_point.append(s)
values.metric_value.append(s.type)
values.start_point = start_point
values.metric_value = remove_duplicate_values(values.metric_value)
return values
@model_validator(mode='after')
def __validator(cls, values):
s_e_values = {}
exclude_values = {}
for f in values.start_point:
s_e_values[f.type] = s_e_values.get(f.type, []) + f.value
for f in values.excludes:
exclude_values[f.type] = exclude_values.get(f.type, []) + f.value
assert len(
values.start_point) <= 1, f"Only 1 startPoint with multiple values OR 1 endPoint with multiple values is allowed"
for t in exclude_values:
for v in t:
assert v not in s_e_values.get(t, []), f"startPoint and endPoint cannot be excluded, value: {v}"
return values
# Union of cards-schemas that doesn't change between FOSS and EE
__cards_union_base = Union[
CardTimeSeries, CardTable, CardFunnel,
CardErrors, CardPerformance, CardResources,
CardWebVital, CardClickMap,
CardPathAnalysis]
CardSchema = ORUnion(Union[__cards_union_base, CardInsights], discriminator='metric_type')
class UpdateCardStatusSchema(BaseModel):
active: bool = Field(...)
class SavedSearchSchema(BaseModel):
name: str = Field(...)
is_public: bool = Field(default=False)
filter: SessionsSearchPayloadSchema = Field([])
class ProjectConditions(BaseModel):
condition_id: Optional[int] = Field(default=None)
name: str = Field(...)
capture_rate: int = Field(..., ge=0, le=100)
filters: List[GroupedFilterType] = Field(default=[])
class ProjectSettings(BaseModel):
rate: int = Field(..., ge=0, le=100)
conditional_capture: bool = Field(default=False)
conditions: List[ProjectConditions] = Field(default=[])
class CreateDashboardSchema(BaseModel):
name: str = Field(..., min_length=1)
description: Optional[str] = Field(default='')
is_public: bool = Field(default=False)
is_pinned: bool = Field(default=False)
metrics: Optional[List[int]] = Field(default=[])
class EditDashboardSchema(CreateDashboardSchema):
is_public: Optional[bool] = Field(default=None)
is_pinned: Optional[bool] = Field(default=None)
class UpdateWidgetPayloadSchema(BaseModel):
config: dict = Field(default={})
class AddWidgetToDashboardPayloadSchema(UpdateWidgetPayloadSchema):
metric_id: int = Field(...)
class TemplatePredefinedUnits(str, Enum):
millisecond = "ms"
second = "s"
minute = "min"
memory = "mb"
frame = "f/s"
percentage = "%"
count = "count"
class LiveFilterType(str, Enum):
user_os = FilterType.user_os.value
user_browser = FilterType.user_browser.value
user_device = FilterType.user_device.value
user_country = FilterType.user_country.value
user_id = FilterType.user_id.value
user_anonymous_id = FilterType.user_anonymous_id.value
rev_id = FilterType.rev_id.value
platform = FilterType.platform.value
page_title = "pageTitle"
session_id = "sessionId"
metadata = FilterType.metadata.value
user_UUID = "userUuid"
tracker_version = "trackerVersion"
user_browser_version = "userBrowserVersion"
user_device_type = "userDeviceType"
class LiveSessionSearchFilterSchema(BaseModel):
value: Union[List[str], str] = Field(...)
type: LiveFilterType = Field(...)
source: Optional[str] = Field(default=None)
operator: Literal[SearchEventOperator._is, \
SearchEventOperator._contains] = Field(default=SearchEventOperator._contains)
transform = model_validator(mode='before')(transform_old_filter_type)
@model_validator(mode='after')
def __validator(cls, values):
if values.type is not None and values.type == LiveFilterType.metadata:
assert values.source is not None, "source should not be null for METADATA type"
assert len(values.source) > 0, "source should not be empty for METADATA type"
return values
class LiveSessionsSearchPayloadSchema(_PaginatedSchema):
filters: List[LiveSessionSearchFilterSchema] = Field([])
sort: Union[LiveFilterType, str] = Field(default="TIMESTAMP")
order: SortOrderType = Field(default=SortOrderType.desc)
@model_validator(mode="before")
def __transform(cls, values):
if values.get("order") is not None:
values["order"] = values["order"].upper()
if values.get("filters") is not None:
i = 0
while i < len(values["filters"]):
if values["filters"][i]["value"] is None or len(values["filters"][i]["value"]) == 0:
del values["filters"][i]
else:
i += 1
for i in values["filters"]:
if i.get("type") == LiveFilterType.platform:
i["type"] = LiveFilterType.user_device_type
if values.get("sort") is not None:
if values["sort"].lower() == "startts":
values["sort"] = "TIMESTAMP"
return values
class IntegrationType(str, Enum):
github = "GITHUB"
jira = "JIRA"
slack = "SLACK"
ms_teams = "MSTEAMS"
sentry = "SENTRY"
bugsnag = "BUGSNAG"
rollbar = "ROLLBAR"
elasticsearch = "ELASTICSEARCH"
datadog = "DATADOG"
sumologic = "SUMOLOGIC"
stackdriver = "STACKDRIVER"
cloudwatch = "CLOUDWATCH"
newrelic = "NEWRELIC"
class SearchNoteSchema(_PaginatedSchema):
sort: str = Field(default="createdAt")
order: SortOrderType = Field(default=SortOrderType.desc)
tags: Optional[List[str]] = Field(default=[])
shared_only: bool = Field(default=False)
mine_only: bool = Field(default=False)
class SessionNoteSchema(BaseModel):
message: str = Field(..., min_length=2)
tag: Optional[str] = Field(default=None)
timestamp: int = Field(default=-1)
is_public: bool = Field(default=False)
class SessionUpdateNoteSchema(SessionNoteSchema):
message: Optional[str] = Field(default=None, min_length=2)
timestamp: Optional[int] = Field(default=None, ge=-1)
is_public: Optional[bool] = Field(default=None)
@model_validator(mode='after')
def __validator(cls, values):
assert values.message is not None or values.timestamp is not None or values.is_public is not None, "at least 1 attribute should be provided for update"
return values
class WebhookType(str, Enum):
webhook = "webhook"
slack = "slack"
email = "email"
msteams = "msteams"
class SearchCardsSchema(_PaginatedSchema):
order: SortOrderType = Field(default=SortOrderType.desc)
shared_only: bool = Field(default=False)
mine_only: bool = Field(default=False)
query: Optional[str] = Field(default=None)
class _ClickMapSearchEventRaw(SessionSearchEventSchema2):
type: Literal[EventType.location] = Field(...)
class ClickMapSessionsSearch(SessionsSearchPayloadSchema):
events: Optional[List[_ClickMapSearchEventRaw]] = Field(default=[])
filters: List[Union[SessionSearchFilterSchema, _ClickMapSearchEventRaw]] = Field(default=[])
@model_validator(mode="before")
def __transform(cls, values):
for f in values.get("filters", []):
if f.get("type") == FilterType.duration:
return values
values["filters"] = values.get("filters", [])
values["filters"].append({"value": [5000], "type": FilterType.duration,
"operator": SearchEventOperator._is, "filters": []})
return values
class ClickMapFilterSchema(BaseModel):
value: List[Literal[IssueType.click_rage, IssueType.dead_click]] = Field(default=[])
type: Literal[FilterType.issue] = Field(...)
operator: Literal[SearchEventOperator._is, MathOperator._equal] = Field(...)
class GetHeatmapPayloadSchema(_TimedSchema):
url: str = Field(...)
filters: List[ClickMapFilterSchema] = Field(default=[])
click_rage: bool = Field(default=False)
class FeatureFlagVariant(BaseModel):
variant_id: Optional[int] = Field(default=None)
value: str = Field(...)
description: Optional[str] = Field(default=None)
payload: Optional[str] = Field(default=None)
rollout_percentage: Optional[int] = Field(default=0, ge=0, le=100)
class FeatureFlagConditionFilterSchema(BaseModel):
is_event: Literal[False] = False
type: FilterType = Field(...)
value: List[str] = Field(default=[], min_length=1)
operator: Union[SearchEventOperator, MathOperator] = Field(...)
source: Optional[str] = Field(default=None)
sourceOperator: Optional[Union[SearchEventOperator, MathOperator]] = Field(default=None)
@model_validator(mode="before")
def __force_is_event(cls, values):
values["isEvent"] = False
return values
class FeatureFlagCondition(BaseModel):
condition_id: Optional[int] = Field(default=None)
name: str = Field(...)
rollout_percentage: Optional[int] = Field(default=0)
filters: List[FeatureFlagConditionFilterSchema] = Field(default=[])
class SearchFlagsSchema(_PaginatedSchema):
limit: int = Field(default=15, gt=0, le=200)
user_id: Optional[int] = Field(default=None)
order: SortOrderType = Field(default=SortOrderType.desc)
query: Optional[str] = Field(default=None)
is_active: Optional[bool] = Field(default=None)
class FeatureFlagType(str, Enum):
single_variant = "single"
multi_variant = "multi"
class FeatureFlagStatus(BaseModel):
is_active: bool = Field(...)
class FeatureFlagSchema(BaseModel):
payload: Optional[str] = Field(default=None)
flag_key: str = Field(..., pattern=r'^[a-zA-Z0-9\-]+$')
description: Optional[str] = Field(default=None)
flag_type: FeatureFlagType = Field(default=FeatureFlagType.single_variant)
is_persist: Optional[bool] = Field(default=False)
is_active: Optional[bool] = Field(default=True)
conditions: List[FeatureFlagCondition] = Field(default=[], min_length=1)
variants: List[FeatureFlagVariant] = Field(default=[])
class ModuleStatus(BaseModel):
module: Literal["assist", "notes", "bug-reports",
"offline-recordings", "alerts", "assist-statts", "recommendations", "feature-flags"] = Field(...,
description="Possible values: assist, notes, bug-reports, offline-recordings, alerts, assist-statts, recommendations, feature-flags")
status: bool = Field(...)
class TagUpdate(BaseModel):
name: str = Field(..., min_length=1, max_length=100, pattern='^[a-zA-Z0-9\" -]*$')
class TagCreate(TagUpdate):
selector: str = Field(..., min_length=1, max_length=255)
ignoreClickRage: bool = Field(default=False)
ignoreDeadClick: bool = Field(default=False)