From 0df37fc98c5954328895b7b6389364b410417cd3 Mon Sep 17 00:00:00 2001 From: "fingerprint-dx-team-actions-runner[bot]" <197604345+fingerprint-dx-team-actions-runner[bot]@users.noreply.github.com> Date: Thu, 12 Nov 2026 23:35:39 +0000 Subject: [PATCH 1/5] feat: sync OpenAPI schema to v3.11.0 --- .changeset/event-discriminated-union.md | 5 + .changeset/event-simulator-browser.md | 5 + .schema-version | 2 +- resources/fingerprint-server-api.yaml | 121 ++++++- src/generatedApiTypes.ts | 78 ++++- .../errors/400_bot_type_invalid.json | 6 + .../errors/400_edge_event_not_updatable.json | 6 + .../errors/400_edge_ip_required.json | 6 + .../errors/400_edge_unknown_field.json | 6 + .../errors/400_end_time_invalid.json | 6 + .../errors/400_event_id_invalid.json | 6 + .../errors/400_event_too_old.json | 6 + .../errors/400_ip_address_invalid.json | 6 + .../errors/400_limit_invalid.json | 6 + .../errors/400_linked_id_invalid.json | 6 + .../errors/400_pagination_key_invalid.json | 6 + .../errors/400_request_read_timeout.json | 6 + .../errors/400_reverse_invalid.json | 6 + .../errors/400_ruleset_not_found.json | 6 + .../errors/400_start_time_invalid.json | 6 + .../errors/400_visitor_id_required.json | 6 + .../errors/403_secret_api_key_not_found.json | 6 + .../errors/403_secret_api_key_required.json | 6 + .../errors/403_subscription_not_active.json | 6 + .../errors/403_wrong_region.json | 6 + .../errors/413_payload_too_large.json | 6 + .../errors/429_too_many_search_requests.json | 6 + .../errors/500_internal_server_error.json | 6 + .../errors/503_service_unavailable.json | 6 + .../errors/504_search_timeout_exceeded.json | 6 + .../events/get_event_200.json | 5 + .../get_event_200_with_unknown_field.json | 331 ++++++++++++++++++ .../events/get_event_ruleset_200.json | 5 + .../events/get_event_with_bot_info_200.json | 329 +++++++++++++++++ .../events/get_event_with_edge_200.json | 51 +++ .../events/search/get_event_search_200.json | 5 + .../search/get_event_search_edge_200.json | 56 +++ .../update_event_multiple_fields_request.json | 7 + .../update_event_one_field_request.json | 3 + .../webhook/webhook_event.json | 1 + 40 files changed, 1123 insertions(+), 31 deletions(-) create mode 100644 .changeset/event-discriminated-union.md create mode 100644 .changeset/event-simulator-browser.md create mode 100644 tests/mocked-responses-tests/mocked-responses-data/errors/400_bot_type_invalid.json create mode 100644 tests/mocked-responses-tests/mocked-responses-data/errors/400_edge_event_not_updatable.json create mode 100644 tests/mocked-responses-tests/mocked-responses-data/errors/400_edge_ip_required.json create mode 100644 tests/mocked-responses-tests/mocked-responses-data/errors/400_edge_unknown_field.json create mode 100644 tests/mocked-responses-tests/mocked-responses-data/errors/400_end_time_invalid.json create mode 100644 tests/mocked-responses-tests/mocked-responses-data/errors/400_event_id_invalid.json create mode 100644 tests/mocked-responses-tests/mocked-responses-data/errors/400_event_too_old.json create mode 100644 tests/mocked-responses-tests/mocked-responses-data/errors/400_ip_address_invalid.json create mode 100644 tests/mocked-responses-tests/mocked-responses-data/errors/400_limit_invalid.json create mode 100644 tests/mocked-responses-tests/mocked-responses-data/errors/400_linked_id_invalid.json create mode 100644 tests/mocked-responses-tests/mocked-responses-data/errors/400_pagination_key_invalid.json create mode 100644 tests/mocked-responses-tests/mocked-responses-data/errors/400_request_read_timeout.json create mode 100644 tests/mocked-responses-tests/mocked-responses-data/errors/400_reverse_invalid.json create mode 100644 tests/mocked-responses-tests/mocked-responses-data/errors/400_ruleset_not_found.json create mode 100644 tests/mocked-responses-tests/mocked-responses-data/errors/400_start_time_invalid.json create mode 100644 tests/mocked-responses-tests/mocked-responses-data/errors/400_visitor_id_required.json create mode 100644 tests/mocked-responses-tests/mocked-responses-data/errors/403_secret_api_key_not_found.json create mode 100644 tests/mocked-responses-tests/mocked-responses-data/errors/403_secret_api_key_required.json create mode 100644 tests/mocked-responses-tests/mocked-responses-data/errors/403_subscription_not_active.json create mode 100644 tests/mocked-responses-tests/mocked-responses-data/errors/403_wrong_region.json create mode 100644 tests/mocked-responses-tests/mocked-responses-data/errors/413_payload_too_large.json create mode 100644 tests/mocked-responses-tests/mocked-responses-data/errors/429_too_many_search_requests.json create mode 100644 tests/mocked-responses-tests/mocked-responses-data/errors/500_internal_server_error.json create mode 100644 tests/mocked-responses-tests/mocked-responses-data/errors/503_service_unavailable.json create mode 100644 tests/mocked-responses-tests/mocked-responses-data/errors/504_search_timeout_exceeded.json create mode 100644 tests/mocked-responses-tests/mocked-responses-data/events/get_event_200_with_unknown_field.json create mode 100644 tests/mocked-responses-tests/mocked-responses-data/events/get_event_with_bot_info_200.json create mode 100644 tests/mocked-responses-tests/mocked-responses-data/events/get_event_with_edge_200.json create mode 100644 tests/mocked-responses-tests/mocked-responses-data/events/search/get_event_search_edge_200.json create mode 100644 tests/mocked-responses-tests/mocked-responses-data/events/update_event_multiple_fields_request.json create mode 100644 tests/mocked-responses-tests/mocked-responses-data/events/update_event_one_field_request.json diff --git a/.changeset/event-discriminated-union.md b/.changeset/event-discriminated-union.md new file mode 100644 index 00000000..7c40631e --- /dev/null +++ b/.changeset/event-discriminated-union.md @@ -0,0 +1,5 @@ +--- +'@fingerprint/node-sdk': minor +--- + +**events**: Split `Event` into `EventDevice` and `EventEdge` subtypes, discriminated by the `source` field; `EventEdge` replaces `EdgeResponse` diff --git a/.changeset/event-simulator-browser.md b/.changeset/event-simulator-browser.md new file mode 100644 index 00000000..72fd5905 --- /dev/null +++ b/.changeset/event-simulator-browser.md @@ -0,0 +1,5 @@ +--- +'@fingerprint/node-sdk': minor +--- + +**events**: Add `simulator` signal support for the browser platform diff --git a/.schema-version b/.schema-version index aef07c2c..ede94c1b 100644 --- a/.schema-version +++ b/.schema-version @@ -1 +1 @@ -v3.10.0 \ No newline at end of file +v3.11.0 \ No newline at end of file diff --git a/resources/fingerprint-server-api.yaml b/resources/fingerprint-server-api.yaml index 5e7f0816..ac4adb7c 100644 --- a/resources/fingerprint-server-api.yaml +++ b/resources/fingerprint-server-api.yaml @@ -943,7 +943,8 @@ paths: schema: type: boolean description: > - Filter events by iOS Simulator Detection result. + Filter events by the Simulator Detection result (native iOS SDK and + Safari on iOS). > Note: When using this parameter, only events with the `simulator` @@ -1212,6 +1213,11 @@ components: enum: - device - edge + EnvironmentId: + type: string + examples: + - ae_47abaca3db2c7c43 + description: Environment ID of the event. Url: type: string examples: @@ -1619,6 +1625,55 @@ components: description: > `true` if the request came from a device running a VPN, `false` otherwise. + EventEdge: + type: object + description: >- + An event generated by the Automation Intelligence API (`source` is + `edge`), containing IP and bot analysis for a request intercepted at the + edge. No client-side agent is involved, so Identification (`visitor_id`) + and Smart Signals derived from device telemetry are not available. + `ip_info` is always present, but is empty when no IP intelligence is + available for the request. `environment_id` is only included in + webhooks, when the `/edge` request was authenticated with an + environment-scoped secret API key. API responses (`POST /v4/edge`, `GET + /v4/events`) never include it. + required: + - event_id + - timestamp + - source + - ip_info + properties: + event_id: + $ref: '#/components/schemas/EventId' + timestamp: + $ref: '#/components/schemas/Timestamp' + source: + $ref: '#/components/schemas/EventSource' + const: edge + linked_id: + $ref: '#/components/schemas/LinkedId' + environment_id: + $ref: '#/components/schemas/EnvironmentId' + tags: + $ref: '#/components/schemas/Tags' + url: + $ref: '#/components/schemas/Url' + bot_info: + $ref: '#/components/schemas/BotInfo' + ip_info: + $ref: '#/components/schemas/IPInfo' + proxy: + $ref: '#/components/schemas/Proxy' + proxy_confidence: + $ref: '#/components/schemas/ProxyConfidence' + proxy_details: + $ref: '#/components/schemas/ProxyDetails' + vpn: + $ref: '#/components/schemas/Vpn' + vpn_confidence: + $ref: '#/components/schemas/VpnConfidence' + vpn_methods: + $ref: '#/components/schemas/VpnMethods' ErrorCode: type: string enum: @@ -1728,11 +1783,6 @@ components: enum: - partially_completed - completed - EnvironmentId: - type: string - examples: - - ae_47abaca3db2c7c43 - description: Environment ID of the event. Suspect: type: boolean description: >- @@ -2378,10 +2428,14 @@ components: block: '#/components/schemas/EventRuleActionBlock' Simulator: type: boolean - description: | - iOS specific simulator detection. There are 2 values: + description: > + Flags requests coming from an iOS Simulator. Covers the native iOS SDK + and Safari running inside the iOS Simulator. There are 2 values: + * `true` - Simulator environment detected. - * `false` - No signs of simulator or the client is not iOS. + + * `false` - No signs of a simulator, or the request does not come from + iOS (native iOS SDK or Safari on iOS). SuspectScore: type: integer examples: @@ -3159,18 +3213,21 @@ components: case. This field is in the beta phase and only available to select customers. If you are interested, please [contact our support team](https://fingerprint.com/support/). - Event: + EventDevice: type: object description: >- - Contains results from Fingerprint Identification and all active Smart - Signals. Some Smart Signals are only supported for certain device types, - these fields will be omitted for events not generated from the supported - devices. Consult the [Smart Signals + An event generated by the JS agent or a mobile SDK running on an + end-user device (`source` is `device`). Contains results from + Fingerprint Identification and all active Smart Signals. Some Smart + Signals are only supported for certain device types, these fields will + be omitted for events not generated from the supported devices. Consult + the [Smart Signals reference](https://docs.fingerprint.com/docs/smart-signals-reference) for more details. required: - event_id - timestamp + - source properties: event_id: $ref: '#/components/schemas/EventId' @@ -3186,6 +3243,7 @@ components: - browser source: $ref: '#/components/schemas/EventSource' + const: device x-platforms: - android - ios @@ -3414,6 +3472,7 @@ components: $ref: '#/components/schemas/Simulator' x-platforms: - ios + - browser suspect_score: $ref: '#/components/schemas/SuspectScore' x-platforms: @@ -3518,6 +3577,40 @@ components: - browser - ios - android + Event: + type: object + description: > + A Device Intelligence or Automation Intelligence event. Check `source` + first, because it determines which properties the event can contain. + + + Both sources can contain: + + - Request metadata like `event_id`, `timestamp`, `source`, `linked_id`, + `environment_id`, `tags`, `url`. + + - IP and bot analysis fields like `ip_info`, `bot_info`, `proxy`, `vpn`. + + + Sources: + + - `device` - generated by the Fingerprint JavaScript agent or a mobile + SDK running on an end-user device. Also contains Identification + (`visitor_id`) and Smart Signals derived from device telemetry. See + `EventDevice`. + + - `edge` - generated by the Automation Intelligence API (`/edge` + endpoint) for a request intercepted at the edge. Contains only the + properties above. See `EventEdge`. + required: [] + oneOf: + - $ref: '#/components/schemas/EventDevice' + - $ref: '#/components/schemas/EventEdge' + discriminator: + propertyName: source + mapping: + device: '#/components/schemas/EventDevice' + edge: '#/components/schemas/EventEdge' EventUpdate: type: object required: [] diff --git a/src/generatedApiTypes.ts b/src/generatedApiTypes.ts index a8fbc211..1b0de959 100644 --- a/src/generatedApiTypes.ts +++ b/src/generatedApiTypes.ts @@ -157,6 +157,11 @@ export interface components { * @enum {string} */ EventSource: 'device' | 'edge' + /** + * @description Environment ID of the event. + * @example ae_47abaca3db2c7c43 + */ + EnvironmentId: string /** * @description Page URL from which the request was sent. * @example https://www.example.com/login @@ -421,6 +426,41 @@ export interface components { /** @description `true` if the request came from a device running a VPN, `false` otherwise. */ ml_prediction?: boolean } + /** @description An event generated by the Automation Intelligence API (`source` is `edge`), containing IP and bot analysis for a request intercepted at the edge. No client-side agent is involved, so Identification (`visitor_id`) and Smart Signals derived from device telemetry are not available. `ip_info` is always present, but is empty when no IP intelligence is available for the request. `environment_id` is only included in webhooks, when the `/edge` request was authenticated with an environment-scoped secret API key. API responses (`POST /v4/edge`, `GET /v4/events`) never include it. */ + EventEdge: { + /** @description Unique identifier of the user's request. The first portion of the event_id is a unix epoch milliseconds timestamp. */ + event_id: components['schemas']['EventId'] + /** @description Timestamp of the event with millisecond precision in Unix time. */ + timestamp: components['schemas']['Timestamp'] + /** + * @description discriminator enum property added by openapi-typescript + * @enum {string} + */ + source: 'edge' + /** @description A customer-provided ID that was sent with the request. */ + linked_id?: components['schemas']['LinkedId'] + /** @description Environment ID of the event. */ + environment_id?: components['schemas']['EnvironmentId'] + /** @description A customer-provided value or an object that was sent with the identification request or updated later. */ + tags?: components['schemas']['Tags'] + /** @description Page URL from which the request was sent. */ + url?: components['schemas']['Url'] + /** @description Extended bot information. */ + bot_info?: components['schemas']['BotInfo'] + /** @description Details about the request IP address. Has separate fields for v4 and v6 IP address versions. */ + ip_info: components['schemas']['IPInfo'] + /** @description IP address was used by a public proxy provider or belonged to a known recent residential proxy */ + proxy?: components['schemas']['Proxy'] + /** @description Confidence level of the proxy detection. If a proxy is not detected, confidence is "high". If it's detected, can be "low", "medium", or "high". */ + proxy_confidence?: components['schemas']['ProxyConfidence'] + /** @description Proxy detection details (present if `proxy` is `true`) */ + proxy_details?: components['schemas']['ProxyDetails'] + /** @description VPN or other anonymizing service has been used when sending the request. */ + vpn?: components['schemas']['Vpn'] + /** @description A confidence rating for the VPN detection result — "low", "medium", or "high". Depends on the combination of results returned from all VPN detection methods. */ + vpn_confidence?: components['schemas']['VpnConfidence'] + vpn_methods?: components['schemas']['VpnMethods'] + } /** * @description Error code: * * `request_cannot_be_parsed` - The query parameters or JSON payload contains some errors @@ -508,11 +548,6 @@ export interface components { * @enum {string} */ IncrementalIdentificationStatus: 'partially_completed' | 'completed' - /** - * @description Environment ID of the event. - * @example ae_47abaca3db2c7c43 - */ - EnvironmentId: string /** @description Field is `true` if you have previously set the `suspect` flag for this event using the [Server API Update event endpoint](https://docs.fingerprint.com/reference/server-api-update-event). */ Suspect: boolean Integration: { @@ -894,9 +929,9 @@ export interface components { /** @description Describes the action the client should take, according to the rule in the ruleset that matched the event. When getting an event by event ID, the rule_action will only be included when the ruleset_id query parameter is specified. */ EventRuleAction: components['schemas']['EventRuleActionAllow'] | components['schemas']['EventRuleActionBlock'] /** - * @description iOS specific simulator detection. There are 2 values: + * @description Flags requests coming from an iOS Simulator. Covers the native iOS SDK and Safari running inside the iOS Simulator. There are 2 values: * * `true` - Simulator environment detected. - * * `false` - No signs of simulator or the client is not iOS. + * * `false` - No signs of a simulator, or the request does not come from iOS (native iOS SDK or Safari on iOS). */ Simulator: boolean /** @@ -1416,18 +1451,17 @@ export interface components { */ ml_score?: number }[] - /** @description Contains results from Fingerprint Identification and all active Smart Signals. Some Smart Signals are only supported for certain device types, these fields will be omitted for events not generated from the supported devices. Consult the [Smart Signals reference](https://docs.fingerprint.com/docs/smart-signals-reference) for more details. */ - Event: { + /** @description An event generated by the JS agent or a mobile SDK running on an end-user device (`source` is `device`). Contains results from Fingerprint Identification and all active Smart Signals. Some Smart Signals are only supported for certain device types, these fields will be omitted for events not generated from the supported devices. Consult the [Smart Signals reference](https://docs.fingerprint.com/docs/smart-signals-reference) for more details. */ + EventDevice: { /** @description Unique identifier of the user's request. The first portion of the event_id is a unix epoch milliseconds timestamp. */ event_id: components['schemas']['EventId'] /** @description Timestamp of the event with millisecond precision in Unix time. */ timestamp: components['schemas']['Timestamp'] /** - * @description Identifies how the event was generated. - * - `device` - the event was generated by the JS agent or a mobile SDK running on an end-user device. - * - `edge` - the event was generated by the Automation Intelligence API (`/edge` endpoint), analyzing a request intercepted at the edge. + * @description discriminator enum property added by openapi-typescript + * @enum {string} */ - source?: components['schemas']['EventSource'] + source: 'device' /** * @description Only included for requests using incremental identification. * - `partially_completed` - Indicates this event corresponds to a 'minimal' request. Smart Signals, even if included in your plan, are not computed; hence, their values must be ignored. @@ -1547,9 +1581,9 @@ export interface components { /** @description Describes the action the client should take, according to the rule in the ruleset that matched the event. When getting an event by event ID, the rule_action will only be included when the ruleset_id query parameter is specified. */ rule_action?: components['schemas']['EventRuleAction'] /** - * @description iOS specific simulator detection. There are 2 values: + * @description Flags requests coming from an iOS Simulator. Covers the native iOS SDK and Safari running inside the iOS Simulator. There are 2 values: * * `true` - Simulator environment detected. - * * `false` - No signs of simulator or the client is not iOS. + * * `false` - No signs of a simulator, or the request does not come from iOS (native iOS SDK or Safari on iOS). */ simulator?: components['schemas']['Simulator'] /** @description Suspect Score is an easy way to integrate Smart Signals into your fraud protection work flow. It is a weighted representation of all Smart Signals present in the payload that helps identify suspicious activity. The value range is [0; S] where S is sum of all Smart Signals weights. See more details here: https://docs.fingerprint.com/docs/suspect-score */ @@ -1627,6 +1661,18 @@ export interface components { /** @description Each label returns a prediction (true or false) for a specific use case (label field) based on a machine learning score. The machine learning score is determined by a model trained on customer data for that use case. This field is in the beta phase and only available to select customers. If you are interested, please [contact our support team](https://fingerprint.com/support/). */ labels?: components['schemas']['Labels'] } + /** + * @description A Device Intelligence or Automation Intelligence event. Check `source` first, because it determines which properties the event can contain. + * + * Both sources can contain: + * - Request metadata like `event_id`, `timestamp`, `source`, `linked_id`, `environment_id`, `tags`, `url`. + * - IP and bot analysis fields like `ip_info`, `bot_info`, `proxy`, `vpn`. + * + * Sources: + * - `device` - generated by the Fingerprint JavaScript agent or a mobile SDK running on an end-user device. Also contains Identification (`visitor_id`) and Smart Signals derived from device telemetry. See `EventDevice`. + * - `edge` - generated by the Automation Intelligence API (`/edge` endpoint) for a request intercepted at the edge. Contains only the properties above. See `EventEdge`. + */ + Event: components['schemas']['EventDevice'] | components['schemas']['EventEdge'] EventUpdate: { /** * @description Linked ID value to assign to the existing event @@ -2166,7 +2212,7 @@ export interface operations { /** @description Filter events by their incremental identification status (`incremental_identification_status` property). Non incremental identification events are left out of the response. */ incremental_identification_status?: components['schemas']['SearchEventsIncrementalIdentificationStatus'] /** - * @description Filter events by iOS Simulator Detection result. + * @description Filter events by the Simulator Detection result (native iOS SDK and Safari on iOS). * * > Note: When using this parameter, only events with the `simulator` property set to `true` or `false` are returned. Events without a `simulator` Smart Signal result are left out of the response. */ diff --git a/tests/mocked-responses-tests/mocked-responses-data/errors/400_bot_type_invalid.json b/tests/mocked-responses-tests/mocked-responses-data/errors/400_bot_type_invalid.json new file mode 100644 index 00000000..caa21bf4 --- /dev/null +++ b/tests/mocked-responses-tests/mocked-responses-data/errors/400_bot_type_invalid.json @@ -0,0 +1,6 @@ +{ + "error": { + "code": "request_cannot_be_parsed", + "message": "invalid bot type" + } +} diff --git a/tests/mocked-responses-tests/mocked-responses-data/errors/400_edge_event_not_updatable.json b/tests/mocked-responses-tests/mocked-responses-data/errors/400_edge_event_not_updatable.json new file mode 100644 index 00000000..a74f678a --- /dev/null +++ b/tests/mocked-responses-tests/mocked-responses-data/errors/400_edge_event_not_updatable.json @@ -0,0 +1,6 @@ +{ + "error": { + "code": "failed", + "message": "edge events cannot be updated" + } +} diff --git a/tests/mocked-responses-tests/mocked-responses-data/errors/400_edge_ip_required.json b/tests/mocked-responses-tests/mocked-responses-data/errors/400_edge_ip_required.json new file mode 100644 index 00000000..8f055f8f --- /dev/null +++ b/tests/mocked-responses-tests/mocked-responses-data/errors/400_edge_ip_required.json @@ -0,0 +1,6 @@ +{ + "error": { + "code": "request_cannot_be_parsed", + "message": "at least one of ipv4_address or ipv6_address is required" + } +} diff --git a/tests/mocked-responses-tests/mocked-responses-data/errors/400_edge_unknown_field.json b/tests/mocked-responses-tests/mocked-responses-data/errors/400_edge_unknown_field.json new file mode 100644 index 00000000..c0a153ef --- /dev/null +++ b/tests/mocked-responses-tests/mocked-responses-data/errors/400_edge_unknown_field.json @@ -0,0 +1,6 @@ +{ + "error": { + "code": "request_cannot_be_parsed", + "message": "request body contains an unknown field \"unknown\"" + } +} \ No newline at end of file diff --git a/tests/mocked-responses-tests/mocked-responses-data/errors/400_end_time_invalid.json b/tests/mocked-responses-tests/mocked-responses-data/errors/400_end_time_invalid.json new file mode 100644 index 00000000..7b4eb466 --- /dev/null +++ b/tests/mocked-responses-tests/mocked-responses-data/errors/400_end_time_invalid.json @@ -0,0 +1,6 @@ +{ + "error": { + "code": "request_cannot_be_parsed", + "message": "invalid end time" + } +} \ No newline at end of file diff --git a/tests/mocked-responses-tests/mocked-responses-data/errors/400_event_id_invalid.json b/tests/mocked-responses-tests/mocked-responses-data/errors/400_event_id_invalid.json new file mode 100644 index 00000000..5c43577e --- /dev/null +++ b/tests/mocked-responses-tests/mocked-responses-data/errors/400_event_id_invalid.json @@ -0,0 +1,6 @@ +{ + "error": { + "code": "request_cannot_be_parsed", + "message": "invalid event_id" + } +} diff --git a/tests/mocked-responses-tests/mocked-responses-data/errors/400_event_too_old.json b/tests/mocked-responses-tests/mocked-responses-data/errors/400_event_too_old.json new file mode 100644 index 00000000..b6fdc58d --- /dev/null +++ b/tests/mocked-responses-tests/mocked-responses-data/errors/400_event_too_old.json @@ -0,0 +1,6 @@ +{ + "error": { + "code": "failed", + "message": "event is too old to be updated (> 10 days)" + } +} diff --git a/tests/mocked-responses-tests/mocked-responses-data/errors/400_ip_address_invalid.json b/tests/mocked-responses-tests/mocked-responses-data/errors/400_ip_address_invalid.json new file mode 100644 index 00000000..8f6ab37d --- /dev/null +++ b/tests/mocked-responses-tests/mocked-responses-data/errors/400_ip_address_invalid.json @@ -0,0 +1,6 @@ +{ + "error": { + "code": "request_cannot_be_parsed", + "message": "invalid ip address" + } +} \ No newline at end of file diff --git a/tests/mocked-responses-tests/mocked-responses-data/errors/400_limit_invalid.json b/tests/mocked-responses-tests/mocked-responses-data/errors/400_limit_invalid.json new file mode 100644 index 00000000..9cd005e8 --- /dev/null +++ b/tests/mocked-responses-tests/mocked-responses-data/errors/400_limit_invalid.json @@ -0,0 +1,6 @@ +{ + "error": { + "code": "request_cannot_be_parsed", + "message": "invalid limit" + } +} diff --git a/tests/mocked-responses-tests/mocked-responses-data/errors/400_linked_id_invalid.json b/tests/mocked-responses-tests/mocked-responses-data/errors/400_linked_id_invalid.json new file mode 100644 index 00000000..d573919d --- /dev/null +++ b/tests/mocked-responses-tests/mocked-responses-data/errors/400_linked_id_invalid.json @@ -0,0 +1,6 @@ +{ + "error": { + "code": "request_cannot_be_parsed", + "message": "linked_id can't be greater than 256 characters long" + } +} diff --git a/tests/mocked-responses-tests/mocked-responses-data/errors/400_pagination_key_invalid.json b/tests/mocked-responses-tests/mocked-responses-data/errors/400_pagination_key_invalid.json new file mode 100644 index 00000000..e7597f91 --- /dev/null +++ b/tests/mocked-responses-tests/mocked-responses-data/errors/400_pagination_key_invalid.json @@ -0,0 +1,6 @@ +{ + "error": { + "code": "request_cannot_be_parsed", + "message": "invalid pagination key" + } +} diff --git a/tests/mocked-responses-tests/mocked-responses-data/errors/400_request_read_timeout.json b/tests/mocked-responses-tests/mocked-responses-data/errors/400_request_read_timeout.json new file mode 100644 index 00000000..89daaca8 --- /dev/null +++ b/tests/mocked-responses-tests/mocked-responses-data/errors/400_request_read_timeout.json @@ -0,0 +1,6 @@ +{ + "error": { + "code": "request_read_timeout", + "message": "request read timeout" + } +} \ No newline at end of file diff --git a/tests/mocked-responses-tests/mocked-responses-data/errors/400_reverse_invalid.json b/tests/mocked-responses-tests/mocked-responses-data/errors/400_reverse_invalid.json new file mode 100644 index 00000000..da696b5b --- /dev/null +++ b/tests/mocked-responses-tests/mocked-responses-data/errors/400_reverse_invalid.json @@ -0,0 +1,6 @@ +{ + "error": { + "code": "request_cannot_be_parsed", + "message": "invalid reverse param" + } +} diff --git a/tests/mocked-responses-tests/mocked-responses-data/errors/400_ruleset_not_found.json b/tests/mocked-responses-tests/mocked-responses-data/errors/400_ruleset_not_found.json new file mode 100644 index 00000000..1e4ac5dd --- /dev/null +++ b/tests/mocked-responses-tests/mocked-responses-data/errors/400_ruleset_not_found.json @@ -0,0 +1,6 @@ +{ + "error": { + "code": "ruleset_not_found", + "message": "ruleset not found" + } +} diff --git a/tests/mocked-responses-tests/mocked-responses-data/errors/400_start_time_invalid.json b/tests/mocked-responses-tests/mocked-responses-data/errors/400_start_time_invalid.json new file mode 100644 index 00000000..d564703d --- /dev/null +++ b/tests/mocked-responses-tests/mocked-responses-data/errors/400_start_time_invalid.json @@ -0,0 +1,6 @@ +{ + "error": { + "code": "request_cannot_be_parsed", + "message": "invalid start time" + } +} \ No newline at end of file diff --git a/tests/mocked-responses-tests/mocked-responses-data/errors/400_visitor_id_required.json b/tests/mocked-responses-tests/mocked-responses-data/errors/400_visitor_id_required.json new file mode 100644 index 00000000..e144a892 --- /dev/null +++ b/tests/mocked-responses-tests/mocked-responses-data/errors/400_visitor_id_required.json @@ -0,0 +1,6 @@ +{ + "error": { + "code": "request_cannot_be_parsed", + "message": "visitor id is required" + } +} diff --git a/tests/mocked-responses-tests/mocked-responses-data/errors/403_secret_api_key_not_found.json b/tests/mocked-responses-tests/mocked-responses-data/errors/403_secret_api_key_not_found.json new file mode 100644 index 00000000..7cf7953b --- /dev/null +++ b/tests/mocked-responses-tests/mocked-responses-data/errors/403_secret_api_key_not_found.json @@ -0,0 +1,6 @@ +{ + "error": { + "code": "secret_api_key_not_found", + "message": "no fingerprint workspace found for specified secret API key" + } +} diff --git a/tests/mocked-responses-tests/mocked-responses-data/errors/403_secret_api_key_required.json b/tests/mocked-responses-tests/mocked-responses-data/errors/403_secret_api_key_required.json new file mode 100644 index 00000000..9ed2f958 --- /dev/null +++ b/tests/mocked-responses-tests/mocked-responses-data/errors/403_secret_api_key_required.json @@ -0,0 +1,6 @@ +{ + "error": { + "code": "secret_api_key_required", + "message": "secret API key in header is missing or empty" + } +} diff --git a/tests/mocked-responses-tests/mocked-responses-data/errors/403_subscription_not_active.json b/tests/mocked-responses-tests/mocked-responses-data/errors/403_subscription_not_active.json new file mode 100644 index 00000000..761bbfed --- /dev/null +++ b/tests/mocked-responses-tests/mocked-responses-data/errors/403_subscription_not_active.json @@ -0,0 +1,6 @@ +{ + "error": { + "code": "subscription_not_active", + "message": "forbidden" + } +} diff --git a/tests/mocked-responses-tests/mocked-responses-data/errors/403_wrong_region.json b/tests/mocked-responses-tests/mocked-responses-data/errors/403_wrong_region.json new file mode 100644 index 00000000..3c5fe748 --- /dev/null +++ b/tests/mocked-responses-tests/mocked-responses-data/errors/403_wrong_region.json @@ -0,0 +1,6 @@ +{ + "error": { + "code": "wrong_region", + "message": "wrong region" + } +} diff --git a/tests/mocked-responses-tests/mocked-responses-data/errors/413_payload_too_large.json b/tests/mocked-responses-tests/mocked-responses-data/errors/413_payload_too_large.json new file mode 100644 index 00000000..00a1c6f9 --- /dev/null +++ b/tests/mocked-responses-tests/mocked-responses-data/errors/413_payload_too_large.json @@ -0,0 +1,6 @@ +{ + "error": { + "code": "payload_too_large", + "message": "payload too large" + } +} diff --git a/tests/mocked-responses-tests/mocked-responses-data/errors/429_too_many_search_requests.json b/tests/mocked-responses-tests/mocked-responses-data/errors/429_too_many_search_requests.json new file mode 100644 index 00000000..bc42b32a --- /dev/null +++ b/tests/mocked-responses-tests/mocked-responses-data/errors/429_too_many_search_requests.json @@ -0,0 +1,6 @@ +{ + "error": { + "code": "too_many_requests", + "message": "too many search requests" + } +} diff --git a/tests/mocked-responses-tests/mocked-responses-data/errors/500_internal_server_error.json b/tests/mocked-responses-tests/mocked-responses-data/errors/500_internal_server_error.json new file mode 100644 index 00000000..5a8bc8af --- /dev/null +++ b/tests/mocked-responses-tests/mocked-responses-data/errors/500_internal_server_error.json @@ -0,0 +1,6 @@ +{ + "error": { + "code": "failed", + "message": "internal server error" + } +} \ No newline at end of file diff --git a/tests/mocked-responses-tests/mocked-responses-data/errors/503_service_unavailable.json b/tests/mocked-responses-tests/mocked-responses-data/errors/503_service_unavailable.json new file mode 100644 index 00000000..aebf5cdd --- /dev/null +++ b/tests/mocked-responses-tests/mocked-responses-data/errors/503_service_unavailable.json @@ -0,0 +1,6 @@ +{ + "error": { + "code": "service_unavailable", + "message": "service temporarily unavailable" + } +} diff --git a/tests/mocked-responses-tests/mocked-responses-data/errors/504_search_timeout_exceeded.json b/tests/mocked-responses-tests/mocked-responses-data/errors/504_search_timeout_exceeded.json new file mode 100644 index 00000000..cc5fcbd7 --- /dev/null +++ b/tests/mocked-responses-tests/mocked-responses-data/errors/504_search_timeout_exceeded.json @@ -0,0 +1,6 @@ +{ + "error": { + "code": "failed", + "message": "gateway timeout" + } +} diff --git a/tests/mocked-responses-tests/mocked-responses-data/events/get_event_200.json b/tests/mocked-responses-tests/mocked-responses-data/events/get_event_200.json index a2456b91..5a0fae32 100644 --- a/tests/mocked-responses-tests/mocked-responses-data/events/get_event_200.json +++ b/tests/mocked-responses-tests/mocked-responses-data/events/get_event_200.json @@ -317,6 +317,11 @@ "label": "fraud", "prediction": false, "ml_score": 0.01 + }, + { + "label": "chargebacks", + "prediction": false, + "ml_score": 0.01 } ], "active_call": false, diff --git a/tests/mocked-responses-tests/mocked-responses-data/events/get_event_200_with_unknown_field.json b/tests/mocked-responses-tests/mocked-responses-data/events/get_event_200_with_unknown_field.json new file mode 100644 index 00000000..69e4ad4d --- /dev/null +++ b/tests/mocked-responses-tests/mocked-responses-data/events/get_event_200_with_unknown_field.json @@ -0,0 +1,331 @@ +{ + "linked_id": "somelinkedId", + "tags": {}, + "timestamp": 1708102555327, + "event_id": "1708102555327.NLOjmg", + "source": "device", + "incremental_identification_status": "completed", + "url": "https://www.example.com/login?hope{this{works[!", + "ip_address": "61.127.217.15", + "user_agent": "Mozilla/5.0 (Windows NT 6.1; Win64; x64) ....", + "device": "Other", + "os": "Windows", + "os_version": "7", + "client_referrer": "https://example.com/blog/my-article", + "browser_details": { + "browser_name": "Chrome", + "browser_major_version": "74", + "browser_full_version": "74.0.3729", + "os": "Windows", + "os_version": "7", + "device": "Other", + "unknown_sub_field": "unknown_sub_field_value" + }, + "identification": { + "visitor_id": "Ibk1527CUFmcnjLwIs4A9", + "confidence": { + "score": 0.97, + "version": "1.1" + }, + "visitor_found": false, + "first_seen_at": 1708102555327, + "last_seen_at": 1708102555327 + }, + "supplementary_id_high_recall": { + "visitor_id": "0jnGMkPYXX37DqVa4ZIO3f_hr", + "visitor_found": true, + "confidence": { + "score": 0, + "version": "Not Supported" + }, + "first_seen_at": 1778086556130, + "last_seen_at": 1778604975494 + }, + "proximity": { + "id": "w1aTfd4MCvl", + "precision_radius": 10, + "confidence": 0.95 + }, + "bot": "not_detected", + "root_apps": false, + "emulator": false, + "ip_info": { + "v4": { + "address": "94.142.239.124", + "geolocation": { + "accuracy_radius": 20, + "latitude": 50.05, + "longitude": 14.4, + "postal_code": "150 00", + "timezone": "Europe/Prague", + "city_name": "Prague", + "country_code": "CZ", + "country_name": "Czechia", + "continent_code": "EU", + "continent_name": "Europe", + "subdivisions": [ + { + "iso_code": "10", + "name": "Hlavni mesto Praha" + } + ] + }, + "asn": "7922", + "asn_name": "COMCAST-7922", + "asn_network": "73.136.0.0/13", + "asn_type": "isp", + "datacenter_result": true, + "datacenter_name": "DediPath" + }, + "v6": { + "address": "2001:db8:3333:4444:5555:6666:7777:8888", + "geolocation": { + "accuracy_radius": 5, + "latitude": 49.982, + "longitude": 36.2566, + "postal_code": "10112", + "timezone": "Europe/Berlin", + "city_name": "Berlin", + "country_code": "DE", + "country_name": "Germany", + "continent_code": "EU", + "continent_name": "Europe", + "subdivisions": [ + { + "iso_code": "BE", + "name": "Land Berlin" + } + ] + }, + "asn": "6805", + "asn_name": "Telefonica Germany", + "asn_network": "2a02:3100::/24", + "asn_type": "isp", + "datacenter_result": false, + "datacenter_name": "" + } + }, + "ip_blocklist": { + "email_spam": false, + "attack_source": false, + "tor_node": false + }, + "proxy": true, + "proxy_confidence": "low", + "proxy_details": { + "proxy_type": "residential", + "last_seen_at": 1708102555327, + "provider": "Massive" + }, + "proxy_ml_score": 0.2, + "vpn": false, + "vpn_confidence": "high", + "vpn_ml_score": 0.2, + "vpn_origin_timezone": "Europe/Berlin", + "vpn_origin_country": "unknown", + "vpn_methods": { + "timezone_mismatch": false, + "public_vpn": false, + "auxiliary_mobile": false, + "os_mismatch": false, + "relay": false, + "ml_prediction": false + }, + "incognito": false, + "tampering": false, + "tampering_confidence": "high", + "tampering_ml_score": 0.3231, + "tampering_details": { + "anomaly_score": 0.1955, + "anti_detect_browser": false + }, + "cloned_app": false, + "factory_reset_timestamp": 0, + "jailbroken": false, + "simulator": false, + "frida": false, + "privacy_settings": false, + "virtual_machine": false, + "virtual_machine_ml_score": 0.2, + "location_spoofing": false, + "velocity": { + "distinct_ip": { + "5_minutes": 1, + "1_hour": 1, + "24_hours": 1 + }, + "distinct_linked_id": { + "5_minutes": 1, + "1_hour": 5, + "24_hours": 5 + }, + "distinct_country": { + "5_minutes": 1, + "1_hour": 2, + "24_hours": 2 + }, + "events": { + "5_minutes": 1, + "1_hour": 5, + "24_hours": 5 + }, + "ip_events": { + "5_minutes": 1, + "1_hour": 5, + "24_hours": 5 + }, + "distinct_ip_by_linked_id": { + "5_minutes": 1, + "1_hour": 5, + "24_hours": 5 + }, + "distinct_visitor_id_by_linked_id": { + "5_minutes": 1, + "1_hour": 5, + "24_hours": 5 + } + }, + "developer_tools": false, + "device_details": { + "device_manufacturer": "samsung", + "device_model": "SM-G991U", + "os_version": "13" + }, + "mitm_attack": false, + "sdk": { + "platform": "js", + "version": "3.11.10", + "integrations": [ + { + "name": "fingerprint-pro-react", + "version": "3.11.10", + "subintegration": { + "name": "preact", + "version": "10.21.0" + } + } + ] + }, + "replayed": false, + "high_activity_device": false, + "raw_device_attributes": { + "math": "5f030fa7d2e5f9f757bfaf81642eb1a6", + "vendor": "Google Inc.", + "plugins": [ + { + "description": "Portable Document Format", + "mimeTypes": [ + { + "suffixes": "pdf", + "type": "application/pdf" + }, + { + "suffixes": "pdf", + "type": "text/pdf" + } + ], + "name": "PDF Viewer" + } + ], + "webgl_extensions": { + "context_attributes": "6b1ed336830d2bc96442a9d76373252a", + "extension_parameters": "86a8abb36f0cb30b5946dec0c761d042", + "extensions": "57233d7b10f89fcd1ff95e3837ccd72d", + "parameters": "ea118c48e308bc4b0677118bbb3019ec", + "shader_precisions": "f223dfbcd580cf142da156d93790eb83", + "unsupported_extensions": [] + }, + "cookies_enabled": true, + "webgl_basics": { + "renderer": "WebKit WebGL", + "renderer_unmasked": "ANGLE (Apple, ANGLE Metal Renderer: Apple M4, Unspecified Version)", + "shading_language_version": "WebGL GLSL ES 1.0 (OpenGL ES GLSL ES 1.0 Chromium)", + "vendor": "WebKit", + "vendor_unmasked": "Google Inc. (Apple)", + "version": "WebGL 1.0 (OpenGL ES 2.0 Chromium)" + }, + "canvas": { + "geometry": "db3c1462576a399a03ae93d0ab9eb5c4", + "text": "70c3d3f7eb4408dc37a6bf8af1c51029", + "winding": true + }, + "hardware_concurrency": 10, + "languages": [ + [ + "en-US" + ] + ], + "color_depth": 24, + "fonts": [ + "Arial Unicode MS", + "Gill Sans", + "Helvetica Neue", + "Menlo" + ], + "indexed_db": true, + "touch_support": { + "max_touch_points": 0, + "touch_event": false, + "touch_start": false + }, + "device_memory": 8, + "oscpu": "Windows NT 6.1; Win64; x64", + "architecture": 127, + "screen_resolution": [ + 1920, + 1080 + ], + "timezone": "America/Sao_Paulo", + "emoji": { + "bottom": 32, + "font": "Times", + "height": 18, + "left": 8, + "right": 1608, + "top": 14, + "width": 1600, + "x": 8, + "y": 14 + }, + "font_preferences": { + "apple": 147.5625, + "default": 147.5625, + "min": 9.234375, + "mono": 133.0625, + "sans": 144.015625, + "serif": 147.5625, + "system": 146.09375 + }, + "platform": "MacIntel", + "local_storage": true, + "session_storage": true, + "date_time_locale": "en-US", + "audio": 124.04347745512496, + "keyboard_layout_hash": "691e3845c85c202a1514b6fd7ef17065", + "keyboard_layout_name": "en-US", + "battery_charging": true, + "battery_level": 80, + "battery_low_power_mode": true, + "timezone_offset": "-03:00", + "font_hash": "bb4d842593877975d45017c603ff5994", + "device_manufacturer": "samsung", + "device_model": "SM-S921U" + }, + "rare_device": false, + "rare_device_percentile_bucket": " Date: Mon, 16 Nov 2026 15:17:41 +0000 Subject: [PATCH 2/5] feat: narrow Event on source and add Webhook type (#308) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit ### Context [INTER-2896](https://fingerprintjs.atlassian.net/browse/INTER-2896) | stacked on #307 (schema sync v3.11.0) | replaces prototype #300 ### Why The v3.11.0 schema makes `Event` a union of `EventDevice | EventEdge`, so #307 fails the build until the example, readme, and webhook typing narrow on `source`. ### Things to note - **⚠️ Type-breaking change, released as `minor`.** Reading `event.identification` or `event.rule_action` without checking `source === 'device'` no longer compiles, and `Event` objects without `source` are rejected. The changeset says so explicitly, like the v3.3.0 one in 7.3.0. - **Merge into #307's branch, not `main`.** #307's build fails on `example/getEvent.mjs` without this PR. - **`Event` keeps `source` required; `Webhook` makes it optional on device events.** Webhook bodies stored before `source` existed don't have it, and resends deliver the stored body as-is. So API code checks `source === 'device'`, webhook code checks `source !== 'edge'`. ### Verification On this branch: `pnpm build`, `lint`, `test:dts` and all 135 tests pass. `test:dts` type-checks `example/getEvent.mjs`, the file that fails #307's build. Type tests in `eventType.spec.ts` check that `Webhook` accepts a body without `source`. ### Change outline Public types (`src/types.ts`, `src/index.ts`): ```diff + export EventDevice, EventEdge // variants, now importable type Event = EventDevice | EventEdge // from the schema, `source` required + type Webhook = + | (EventDevice with source?: 'device') // bodies stored before `source` + | EventEdge ``` What users write now: ```diff const event = await client.getEvent(id, { ruleset_id }) - console.log(event.rule_action?.type) + if (event.source === 'device') console.log(event.rule_action?.type) - const event = webhookBody as Event + const webhook = webhookBody as Webhook + if (webhook.source !== 'edge') console.log(webhook.identification) ``` Changesets, rewritten for Node SDK users (all `minor`): ```text event-discriminated-union.md # ⚠️ type-breaking: Event is a union, # check source before device-only fields webhook-type.md # new Webhook type event-simulator-browser.md # simulator also flags Safari in iOS Simulator ``` [INTER-2896]: https://fingerprintjs.atlassian.net/browse/INTER-2896?atlOrigin=eyJpIjoiNWRkNTljNzYxNjVmNDY3MDlhMDU5Y2ZhYzA5YTRkZjUiLCJwIjoiZ2l0aHViLWNvbS1KU1cifQ --- .changeset/event-discriminated-union.md | 13 ++++++++++- .changeset/event-simulator-browser.md | 2 +- .changeset/webhook-type.md | 5 ++++ example/getEvent.mjs | 3 ++- readme.md | 17 ++++++++++---- src/index.ts | 3 +++ src/serverApiClient.ts | 2 ++ src/types.ts | 16 +++++++++++++ .../castWebhookEventTest.spec.ts | 4 ++-- tests/unit-tests/eventType.spec.ts | 23 +++++++++++++++++++ 10 files changed, 79 insertions(+), 9 deletions(-) create mode 100644 .changeset/webhook-type.md create mode 100644 tests/unit-tests/eventType.spec.ts diff --git a/.changeset/event-discriminated-union.md b/.changeset/event-discriminated-union.md index 7c40631e..fa5de33f 100644 --- a/.changeset/event-discriminated-union.md +++ b/.changeset/event-discriminated-union.md @@ -2,4 +2,15 @@ '@fingerprint/node-sdk': minor --- -**events**: Split `Event` into `EventDevice` and `EventEdge` subtypes, discriminated by the `source` field; `EventEdge` replaces `EdgeResponse` +**types**: ⚠️ Type-breaking change in generated TypeScript types for OpenAPI v3.11.0. No runtime change. + +- `Event` is now a union of `EventDevice` and `EventEdge`, discriminated by `source`. Both are exported. Edge events ([Automation Intelligence API](https://docs.fingerprint.com/reference/automation-intelligence-api)) have no Identification, no `rule_action`, and none of the Smart Signals that need device data. They still have IP, proxy, VPN and bot detection. +- Code that reads device-only fields such as `event.identification` or `event.rule_action` no longer compiles. Check `source` first: + + ```ts + if (event.source === 'device') { + console.log(event.rule_action?.type) + } + ``` + +- `source` is now required on `Event`. Objects typed as `Event` without `source` (for example, test fixtures) no longer compile. For webhook bodies, use the new `Webhook` type. diff --git a/.changeset/event-simulator-browser.md b/.changeset/event-simulator-browser.md index 72fd5905..dfe527a3 100644 --- a/.changeset/event-simulator-browser.md +++ b/.changeset/event-simulator-browser.md @@ -2,4 +2,4 @@ '@fingerprint/node-sdk': minor --- -**events**: Add `simulator` signal support for the browser platform +**events**: `simulator` also flags Safari running inside the iOS Simulator, not only the native iOS SDK diff --git a/.changeset/webhook-type.md b/.changeset/webhook-type.md new file mode 100644 index 00000000..4b06dc23 --- /dev/null +++ b/.changeset/webhook-type.md @@ -0,0 +1,5 @@ +--- +'@fingerprint/node-sdk': minor +--- + +**webhooks**: Add `Webhook` type for webhook bodies. Same as `Event`, but `source` is optional on device events, because webhooks stored before `source` existed don't have it. diff --git a/example/getEvent.mjs b/example/getEvent.mjs index 0500d26b..7e531369 100644 --- a/example/getEvent.mjs +++ b/example/getEvent.mjs @@ -32,7 +32,8 @@ try { const event = await client.getEvent(eventId, { ruleset_id: rulesetId }) console.log(JSON.stringify(event, null, 2)) - if (rulesetId && event.rule_action) { + // Only device events have a rule action. + if (rulesetId && event.source === 'device' && event.rule_action) { const { type, ruleset_id, rule_id, rule_expression } = event.rule_action console.log(`Rule action: ${type} (ruleset: ${ruleset_id}, rule: ${rule_id}, expression: ${rule_expression})`) diff --git a/readme.md b/readme.md index a1ee6888..68dbb1d5 100644 --- a/readme.md +++ b/readme.md @@ -97,7 +97,10 @@ client.getEvent('').then((event) => { // Get an event with a ruleset evaluation client.getEvent('', { ruleset_id: '' }).then((event) => { - console.log(event.rule_action?.type) // 'allow' or 'block' + // Only device events have Identification and a rule action, edge events (Automation Intelligence API) don't. + if (event.source === 'device') { + console.log(event.rule_action?.type) // 'allow' or 'block' + } }) // Search for identification events @@ -151,12 +154,18 @@ Other `SdkError`s: #### Webhook types -When handling [Webhooks](https://dev.fingerprint.com/reference/posteventwebhook#/) coming from Fingerprint, you can cast the payload as the built-in `Event` type: +When handling [Webhooks](https://docs.fingerprint.com/reference/posteventwebhook) coming from Fingerprint, you can cast the payload as the built-in `Webhook` type: ```ts -import { Event } from '@fingerprint/node-sdk' +import { Webhook } from '@fingerprint/node-sdk' + +const webhook = eventWebhookBody as unknown as Webhook -const event = eventWebhookBody as unknown as Event +// Edge events (Automation Intelligence API) have no Identification. +// Bodies stored before `source` was added have no `source`; they are device events. +if (webhook.source !== 'edge') { + console.log(webhook.identification?.visitor_id) +} ``` #### Webhook signature validation diff --git a/src/index.ts b/src/index.ts index 2c9f2954..79558aa5 100644 --- a/src/index.ts +++ b/src/index.ts @@ -3,6 +3,8 @@ export { ErrorCode, ErrorResponse, Event, + EventDevice, + EventEdge, EventRuleAction, EventUpdate, GetEventOptions, @@ -10,6 +12,7 @@ export { Region, SearchEventsFilter, SearchEventsResponse, + Webhook, } from './types' export * from './sealedResults' export * from './errors/unsealError' diff --git a/src/serverApiClient.ts b/src/serverApiClient.ts index 408e1070..3753d04e 100644 --- a/src/serverApiClient.ts +++ b/src/serverApiClient.ts @@ -79,6 +79,8 @@ export class FingerprintServerApiClient implements FingerprintApi { * client * .getEvent('', { ruleset_id: '' }) * .then((event) => { + * // Only device events have a rule action. + * if (event.source !== 'device') return * const ruleAction = event.rule_action * if (ruleAction?.type === 'block') { * console.log('Blocked by rule:', ruleAction.rule_id, ruleAction.status_code) diff --git a/src/types.ts b/src/types.ts index 41d97723..6fc7ffe9 100644 --- a/src/types.ts +++ b/src/types.ts @@ -50,6 +50,22 @@ export type SearchEventsResponse = components['schemas']['EventSearch'] */ export type Event = components['schemas']['Event'] +/** Event from the JS agent or a mobile SDK (`source` is `device`), with Identification and Smart Signals. */ +export type EventDevice = components['schemas']['EventDevice'] + +/** Event from the Automation Intelligence API (`source` is `edge`), with IP, proxy, VPN and bot detection. */ +export type EventEdge = components['schemas']['EventEdge'] + +/** + * Body of a webhook sent by Fingerprint. + * Same as {@link Event}, except `source` is optional on device events: bodies stored before `source` was added + * don't have it, and resent webhooks deliver the stored body as-is. Check `source === 'edge'`; anything else is a + * device event. + * + * More info: https://docs.fingerprint.com/reference/posteventwebhook + */ +export type Webhook = (Omit & { source?: 'device' }) | EventEdge + export type GetEventOptions = paths['/events/{event_id}']['get']['parameters']['query'] export type EventUpdate = components['schemas']['EventUpdate'] diff --git a/tests/mocked-responses-tests/castWebhookEventTest.spec.ts b/tests/mocked-responses-tests/castWebhookEventTest.spec.ts index 51f786ff..9e38051a 100644 --- a/tests/mocked-responses-tests/castWebhookEventTest.spec.ts +++ b/tests/mocked-responses-tests/castWebhookEventTest.spec.ts @@ -1,10 +1,10 @@ import { describe, expect, it } from 'vitest' -import { Event } from '../../src' +import { Webhook } from '../../src' import eventWebhookBody from './mocked-responses-data/webhook/webhook_event.json' describe('[Mocked body] Cast webhook event', () => { it('with sample request body', () => { - const event = eventWebhookBody as Event + const event = eventWebhookBody as Webhook // Assertion just to use the `event` variable. The goal of this test is to assume that Typescript won't throw an error here. expect(event).toBeTruthy() diff --git a/tests/unit-tests/eventType.spec.ts b/tests/unit-tests/eventType.spec.ts new file mode 100644 index 00000000..46ec2b5e --- /dev/null +++ b/tests/unit-tests/eventType.spec.ts @@ -0,0 +1,23 @@ +import { describe, expectTypeOf, it } from 'vitest' +import { Event, Webhook } from '../../src' + +// Type-level tests: `pnpm typecheck:tests` fails if these stop compiling. +describe('Webhook type', () => { + it('accepts a device body stored before `source` was added', () => { + const legacy: Webhook = { event_id: '1708102555327.NLOjmg', timestamp: 1708102555327 } + expectTypeOf(legacy).toExtend() + }) + + it("narrows to the device variant on `source !== 'edge'`", () => { + const webhook = {} as Webhook + + if (webhook.source !== 'edge') { + expectTypeOf(webhook.source).toEqualTypeOf<'device' | undefined>() + expectTypeOf(webhook.identification?.visitor_id).toEqualTypeOf() + } + }) + + it('accepts every API event', () => { + expectTypeOf().toExtend() + }) +}) From 65ebbab77d8719cb580b92325ead15ef563727f2 Mon Sep 17 00:00:00 2001 From: Juraj Uhlar Date: Mon, 16 Nov 2026 15:28:09 +0000 Subject: [PATCH 3/5] chore: remove unused mock files --- .../errors/400_bot_type_invalid.json | 6 - .../errors/400_edge_event_not_updatable.json | 6 - .../errors/400_edge_ip_required.json | 6 - .../errors/400_edge_unknown_field.json | 6 - .../errors/400_end_time_invalid.json | 6 - .../errors/400_event_id_invalid.json | 6 - .../errors/400_event_too_old.json | 6 - .../errors/400_ip_address_invalid.json | 6 - .../errors/400_limit_invalid.json | 6 - .../errors/400_linked_id_invalid.json | 6 - .../errors/400_pagination_key_invalid.json | 6 - .../errors/400_request_read_timeout.json | 6 - .../errors/400_reverse_invalid.json | 6 - .../errors/400_ruleset_not_found.json | 6 - .../errors/400_start_time_invalid.json | 6 - .../errors/400_visitor_id_required.json | 6 - .../errors/403_secret_api_key_not_found.json | 6 - .../errors/403_secret_api_key_required.json | 6 - .../errors/403_subscription_not_active.json | 6 - .../errors/403_wrong_region.json | 6 - .../errors/413_payload_too_large.json | 6 - .../errors/429_too_many_search_requests.json | 6 - .../errors/500_internal_server_error.json | 6 - .../errors/503_service_unavailable.json | 6 - .../errors/504_search_timeout_exceeded.json | 6 - .../get_event_200_with_unknown_field.json | 331 ------------------ .../events/get_event_with_bot_info_200.json | 329 ----------------- .../update_event_multiple_fields_request.json | 7 - .../update_event_one_field_request.json | 3 - 29 files changed, 820 deletions(-) delete mode 100644 tests/mocked-responses-tests/mocked-responses-data/errors/400_bot_type_invalid.json delete mode 100644 tests/mocked-responses-tests/mocked-responses-data/errors/400_edge_event_not_updatable.json delete mode 100644 tests/mocked-responses-tests/mocked-responses-data/errors/400_edge_ip_required.json delete mode 100644 tests/mocked-responses-tests/mocked-responses-data/errors/400_edge_unknown_field.json delete mode 100644 tests/mocked-responses-tests/mocked-responses-data/errors/400_end_time_invalid.json delete mode 100644 tests/mocked-responses-tests/mocked-responses-data/errors/400_event_id_invalid.json delete mode 100644 tests/mocked-responses-tests/mocked-responses-data/errors/400_event_too_old.json delete mode 100644 tests/mocked-responses-tests/mocked-responses-data/errors/400_ip_address_invalid.json delete mode 100644 tests/mocked-responses-tests/mocked-responses-data/errors/400_limit_invalid.json delete mode 100644 tests/mocked-responses-tests/mocked-responses-data/errors/400_linked_id_invalid.json delete mode 100644 tests/mocked-responses-tests/mocked-responses-data/errors/400_pagination_key_invalid.json delete mode 100644 tests/mocked-responses-tests/mocked-responses-data/errors/400_request_read_timeout.json delete mode 100644 tests/mocked-responses-tests/mocked-responses-data/errors/400_reverse_invalid.json delete mode 100644 tests/mocked-responses-tests/mocked-responses-data/errors/400_ruleset_not_found.json delete mode 100644 tests/mocked-responses-tests/mocked-responses-data/errors/400_start_time_invalid.json delete mode 100644 tests/mocked-responses-tests/mocked-responses-data/errors/400_visitor_id_required.json delete mode 100644 tests/mocked-responses-tests/mocked-responses-data/errors/403_secret_api_key_not_found.json delete mode 100644 tests/mocked-responses-tests/mocked-responses-data/errors/403_secret_api_key_required.json delete mode 100644 tests/mocked-responses-tests/mocked-responses-data/errors/403_subscription_not_active.json delete mode 100644 tests/mocked-responses-tests/mocked-responses-data/errors/403_wrong_region.json delete mode 100644 tests/mocked-responses-tests/mocked-responses-data/errors/413_payload_too_large.json delete mode 100644 tests/mocked-responses-tests/mocked-responses-data/errors/429_too_many_search_requests.json delete mode 100644 tests/mocked-responses-tests/mocked-responses-data/errors/500_internal_server_error.json delete mode 100644 tests/mocked-responses-tests/mocked-responses-data/errors/503_service_unavailable.json delete mode 100644 tests/mocked-responses-tests/mocked-responses-data/errors/504_search_timeout_exceeded.json delete mode 100644 tests/mocked-responses-tests/mocked-responses-data/events/get_event_200_with_unknown_field.json delete mode 100644 tests/mocked-responses-tests/mocked-responses-data/events/get_event_with_bot_info_200.json delete mode 100644 tests/mocked-responses-tests/mocked-responses-data/events/update_event_multiple_fields_request.json delete mode 100644 tests/mocked-responses-tests/mocked-responses-data/events/update_event_one_field_request.json diff --git a/tests/mocked-responses-tests/mocked-responses-data/errors/400_bot_type_invalid.json b/tests/mocked-responses-tests/mocked-responses-data/errors/400_bot_type_invalid.json deleted file mode 100644 index caa21bf4..00000000 --- a/tests/mocked-responses-tests/mocked-responses-data/errors/400_bot_type_invalid.json +++ /dev/null @@ -1,6 +0,0 @@ -{ - "error": { - "code": "request_cannot_be_parsed", - "message": "invalid bot type" - } -} diff --git a/tests/mocked-responses-tests/mocked-responses-data/errors/400_edge_event_not_updatable.json b/tests/mocked-responses-tests/mocked-responses-data/errors/400_edge_event_not_updatable.json deleted file mode 100644 index a74f678a..00000000 --- a/tests/mocked-responses-tests/mocked-responses-data/errors/400_edge_event_not_updatable.json +++ /dev/null @@ -1,6 +0,0 @@ -{ - "error": { - "code": "failed", - "message": "edge events cannot be updated" - } -} diff --git a/tests/mocked-responses-tests/mocked-responses-data/errors/400_edge_ip_required.json b/tests/mocked-responses-tests/mocked-responses-data/errors/400_edge_ip_required.json deleted file mode 100644 index 8f055f8f..00000000 --- a/tests/mocked-responses-tests/mocked-responses-data/errors/400_edge_ip_required.json +++ /dev/null @@ -1,6 +0,0 @@ -{ - "error": { - "code": "request_cannot_be_parsed", - "message": "at least one of ipv4_address or ipv6_address is required" - } -} diff --git a/tests/mocked-responses-tests/mocked-responses-data/errors/400_edge_unknown_field.json b/tests/mocked-responses-tests/mocked-responses-data/errors/400_edge_unknown_field.json deleted file mode 100644 index c0a153ef..00000000 --- a/tests/mocked-responses-tests/mocked-responses-data/errors/400_edge_unknown_field.json +++ /dev/null @@ -1,6 +0,0 @@ -{ - "error": { - "code": "request_cannot_be_parsed", - "message": "request body contains an unknown field \"unknown\"" - } -} \ No newline at end of file diff --git a/tests/mocked-responses-tests/mocked-responses-data/errors/400_end_time_invalid.json b/tests/mocked-responses-tests/mocked-responses-data/errors/400_end_time_invalid.json deleted file mode 100644 index 7b4eb466..00000000 --- a/tests/mocked-responses-tests/mocked-responses-data/errors/400_end_time_invalid.json +++ /dev/null @@ -1,6 +0,0 @@ -{ - "error": { - "code": "request_cannot_be_parsed", - "message": "invalid end time" - } -} \ No newline at end of file diff --git a/tests/mocked-responses-tests/mocked-responses-data/errors/400_event_id_invalid.json b/tests/mocked-responses-tests/mocked-responses-data/errors/400_event_id_invalid.json deleted file mode 100644 index 5c43577e..00000000 --- a/tests/mocked-responses-tests/mocked-responses-data/errors/400_event_id_invalid.json +++ /dev/null @@ -1,6 +0,0 @@ -{ - "error": { - "code": "request_cannot_be_parsed", - "message": "invalid event_id" - } -} diff --git a/tests/mocked-responses-tests/mocked-responses-data/errors/400_event_too_old.json b/tests/mocked-responses-tests/mocked-responses-data/errors/400_event_too_old.json deleted file mode 100644 index b6fdc58d..00000000 --- a/tests/mocked-responses-tests/mocked-responses-data/errors/400_event_too_old.json +++ /dev/null @@ -1,6 +0,0 @@ -{ - "error": { - "code": "failed", - "message": "event is too old to be updated (> 10 days)" - } -} diff --git a/tests/mocked-responses-tests/mocked-responses-data/errors/400_ip_address_invalid.json b/tests/mocked-responses-tests/mocked-responses-data/errors/400_ip_address_invalid.json deleted file mode 100644 index 8f6ab37d..00000000 --- a/tests/mocked-responses-tests/mocked-responses-data/errors/400_ip_address_invalid.json +++ /dev/null @@ -1,6 +0,0 @@ -{ - "error": { - "code": "request_cannot_be_parsed", - "message": "invalid ip address" - } -} \ No newline at end of file diff --git a/tests/mocked-responses-tests/mocked-responses-data/errors/400_limit_invalid.json b/tests/mocked-responses-tests/mocked-responses-data/errors/400_limit_invalid.json deleted file mode 100644 index 9cd005e8..00000000 --- a/tests/mocked-responses-tests/mocked-responses-data/errors/400_limit_invalid.json +++ /dev/null @@ -1,6 +0,0 @@ -{ - "error": { - "code": "request_cannot_be_parsed", - "message": "invalid limit" - } -} diff --git a/tests/mocked-responses-tests/mocked-responses-data/errors/400_linked_id_invalid.json b/tests/mocked-responses-tests/mocked-responses-data/errors/400_linked_id_invalid.json deleted file mode 100644 index d573919d..00000000 --- a/tests/mocked-responses-tests/mocked-responses-data/errors/400_linked_id_invalid.json +++ /dev/null @@ -1,6 +0,0 @@ -{ - "error": { - "code": "request_cannot_be_parsed", - "message": "linked_id can't be greater than 256 characters long" - } -} diff --git a/tests/mocked-responses-tests/mocked-responses-data/errors/400_pagination_key_invalid.json b/tests/mocked-responses-tests/mocked-responses-data/errors/400_pagination_key_invalid.json deleted file mode 100644 index e7597f91..00000000 --- a/tests/mocked-responses-tests/mocked-responses-data/errors/400_pagination_key_invalid.json +++ /dev/null @@ -1,6 +0,0 @@ -{ - "error": { - "code": "request_cannot_be_parsed", - "message": "invalid pagination key" - } -} diff --git a/tests/mocked-responses-tests/mocked-responses-data/errors/400_request_read_timeout.json b/tests/mocked-responses-tests/mocked-responses-data/errors/400_request_read_timeout.json deleted file mode 100644 index 89daaca8..00000000 --- a/tests/mocked-responses-tests/mocked-responses-data/errors/400_request_read_timeout.json +++ /dev/null @@ -1,6 +0,0 @@ -{ - "error": { - "code": "request_read_timeout", - "message": "request read timeout" - } -} \ No newline at end of file diff --git a/tests/mocked-responses-tests/mocked-responses-data/errors/400_reverse_invalid.json b/tests/mocked-responses-tests/mocked-responses-data/errors/400_reverse_invalid.json deleted file mode 100644 index da696b5b..00000000 --- a/tests/mocked-responses-tests/mocked-responses-data/errors/400_reverse_invalid.json +++ /dev/null @@ -1,6 +0,0 @@ -{ - "error": { - "code": "request_cannot_be_parsed", - "message": "invalid reverse param" - } -} diff --git a/tests/mocked-responses-tests/mocked-responses-data/errors/400_ruleset_not_found.json b/tests/mocked-responses-tests/mocked-responses-data/errors/400_ruleset_not_found.json deleted file mode 100644 index 1e4ac5dd..00000000 --- a/tests/mocked-responses-tests/mocked-responses-data/errors/400_ruleset_not_found.json +++ /dev/null @@ -1,6 +0,0 @@ -{ - "error": { - "code": "ruleset_not_found", - "message": "ruleset not found" - } -} diff --git a/tests/mocked-responses-tests/mocked-responses-data/errors/400_start_time_invalid.json b/tests/mocked-responses-tests/mocked-responses-data/errors/400_start_time_invalid.json deleted file mode 100644 index d564703d..00000000 --- a/tests/mocked-responses-tests/mocked-responses-data/errors/400_start_time_invalid.json +++ /dev/null @@ -1,6 +0,0 @@ -{ - "error": { - "code": "request_cannot_be_parsed", - "message": "invalid start time" - } -} \ No newline at end of file diff --git a/tests/mocked-responses-tests/mocked-responses-data/errors/400_visitor_id_required.json b/tests/mocked-responses-tests/mocked-responses-data/errors/400_visitor_id_required.json deleted file mode 100644 index e144a892..00000000 --- a/tests/mocked-responses-tests/mocked-responses-data/errors/400_visitor_id_required.json +++ /dev/null @@ -1,6 +0,0 @@ -{ - "error": { - "code": "request_cannot_be_parsed", - "message": "visitor id is required" - } -} diff --git a/tests/mocked-responses-tests/mocked-responses-data/errors/403_secret_api_key_not_found.json b/tests/mocked-responses-tests/mocked-responses-data/errors/403_secret_api_key_not_found.json deleted file mode 100644 index 7cf7953b..00000000 --- a/tests/mocked-responses-tests/mocked-responses-data/errors/403_secret_api_key_not_found.json +++ /dev/null @@ -1,6 +0,0 @@ -{ - "error": { - "code": "secret_api_key_not_found", - "message": "no fingerprint workspace found for specified secret API key" - } -} diff --git a/tests/mocked-responses-tests/mocked-responses-data/errors/403_secret_api_key_required.json b/tests/mocked-responses-tests/mocked-responses-data/errors/403_secret_api_key_required.json deleted file mode 100644 index 9ed2f958..00000000 --- a/tests/mocked-responses-tests/mocked-responses-data/errors/403_secret_api_key_required.json +++ /dev/null @@ -1,6 +0,0 @@ -{ - "error": { - "code": "secret_api_key_required", - "message": "secret API key in header is missing or empty" - } -} diff --git a/tests/mocked-responses-tests/mocked-responses-data/errors/403_subscription_not_active.json b/tests/mocked-responses-tests/mocked-responses-data/errors/403_subscription_not_active.json deleted file mode 100644 index 761bbfed..00000000 --- a/tests/mocked-responses-tests/mocked-responses-data/errors/403_subscription_not_active.json +++ /dev/null @@ -1,6 +0,0 @@ -{ - "error": { - "code": "subscription_not_active", - "message": "forbidden" - } -} diff --git a/tests/mocked-responses-tests/mocked-responses-data/errors/403_wrong_region.json b/tests/mocked-responses-tests/mocked-responses-data/errors/403_wrong_region.json deleted file mode 100644 index 3c5fe748..00000000 --- a/tests/mocked-responses-tests/mocked-responses-data/errors/403_wrong_region.json +++ /dev/null @@ -1,6 +0,0 @@ -{ - "error": { - "code": "wrong_region", - "message": "wrong region" - } -} diff --git a/tests/mocked-responses-tests/mocked-responses-data/errors/413_payload_too_large.json b/tests/mocked-responses-tests/mocked-responses-data/errors/413_payload_too_large.json deleted file mode 100644 index 00a1c6f9..00000000 --- a/tests/mocked-responses-tests/mocked-responses-data/errors/413_payload_too_large.json +++ /dev/null @@ -1,6 +0,0 @@ -{ - "error": { - "code": "payload_too_large", - "message": "payload too large" - } -} diff --git a/tests/mocked-responses-tests/mocked-responses-data/errors/429_too_many_search_requests.json b/tests/mocked-responses-tests/mocked-responses-data/errors/429_too_many_search_requests.json deleted file mode 100644 index bc42b32a..00000000 --- a/tests/mocked-responses-tests/mocked-responses-data/errors/429_too_many_search_requests.json +++ /dev/null @@ -1,6 +0,0 @@ -{ - "error": { - "code": "too_many_requests", - "message": "too many search requests" - } -} diff --git a/tests/mocked-responses-tests/mocked-responses-data/errors/500_internal_server_error.json b/tests/mocked-responses-tests/mocked-responses-data/errors/500_internal_server_error.json deleted file mode 100644 index 5a8bc8af..00000000 --- a/tests/mocked-responses-tests/mocked-responses-data/errors/500_internal_server_error.json +++ /dev/null @@ -1,6 +0,0 @@ -{ - "error": { - "code": "failed", - "message": "internal server error" - } -} \ No newline at end of file diff --git a/tests/mocked-responses-tests/mocked-responses-data/errors/503_service_unavailable.json b/tests/mocked-responses-tests/mocked-responses-data/errors/503_service_unavailable.json deleted file mode 100644 index aebf5cdd..00000000 --- a/tests/mocked-responses-tests/mocked-responses-data/errors/503_service_unavailable.json +++ /dev/null @@ -1,6 +0,0 @@ -{ - "error": { - "code": "service_unavailable", - "message": "service temporarily unavailable" - } -} diff --git a/tests/mocked-responses-tests/mocked-responses-data/errors/504_search_timeout_exceeded.json b/tests/mocked-responses-tests/mocked-responses-data/errors/504_search_timeout_exceeded.json deleted file mode 100644 index cc5fcbd7..00000000 --- a/tests/mocked-responses-tests/mocked-responses-data/errors/504_search_timeout_exceeded.json +++ /dev/null @@ -1,6 +0,0 @@ -{ - "error": { - "code": "failed", - "message": "gateway timeout" - } -} diff --git a/tests/mocked-responses-tests/mocked-responses-data/events/get_event_200_with_unknown_field.json b/tests/mocked-responses-tests/mocked-responses-data/events/get_event_200_with_unknown_field.json deleted file mode 100644 index 69e4ad4d..00000000 --- a/tests/mocked-responses-tests/mocked-responses-data/events/get_event_200_with_unknown_field.json +++ /dev/null @@ -1,331 +0,0 @@ -{ - "linked_id": "somelinkedId", - "tags": {}, - "timestamp": 1708102555327, - "event_id": "1708102555327.NLOjmg", - "source": "device", - "incremental_identification_status": "completed", - "url": "https://www.example.com/login?hope{this{works[!", - "ip_address": "61.127.217.15", - "user_agent": "Mozilla/5.0 (Windows NT 6.1; Win64; x64) ....", - "device": "Other", - "os": "Windows", - "os_version": "7", - "client_referrer": "https://example.com/blog/my-article", - "browser_details": { - "browser_name": "Chrome", - "browser_major_version": "74", - "browser_full_version": "74.0.3729", - "os": "Windows", - "os_version": "7", - "device": "Other", - "unknown_sub_field": "unknown_sub_field_value" - }, - "identification": { - "visitor_id": "Ibk1527CUFmcnjLwIs4A9", - "confidence": { - "score": 0.97, - "version": "1.1" - }, - "visitor_found": false, - "first_seen_at": 1708102555327, - "last_seen_at": 1708102555327 - }, - "supplementary_id_high_recall": { - "visitor_id": "0jnGMkPYXX37DqVa4ZIO3f_hr", - "visitor_found": true, - "confidence": { - "score": 0, - "version": "Not Supported" - }, - "first_seen_at": 1778086556130, - "last_seen_at": 1778604975494 - }, - "proximity": { - "id": "w1aTfd4MCvl", - "precision_radius": 10, - "confidence": 0.95 - }, - "bot": "not_detected", - "root_apps": false, - "emulator": false, - "ip_info": { - "v4": { - "address": "94.142.239.124", - "geolocation": { - "accuracy_radius": 20, - "latitude": 50.05, - "longitude": 14.4, - "postal_code": "150 00", - "timezone": "Europe/Prague", - "city_name": "Prague", - "country_code": "CZ", - "country_name": "Czechia", - "continent_code": "EU", - "continent_name": "Europe", - "subdivisions": [ - { - "iso_code": "10", - "name": "Hlavni mesto Praha" - } - ] - }, - "asn": "7922", - "asn_name": "COMCAST-7922", - "asn_network": "73.136.0.0/13", - "asn_type": "isp", - "datacenter_result": true, - "datacenter_name": "DediPath" - }, - "v6": { - "address": "2001:db8:3333:4444:5555:6666:7777:8888", - "geolocation": { - "accuracy_radius": 5, - "latitude": 49.982, - "longitude": 36.2566, - "postal_code": "10112", - "timezone": "Europe/Berlin", - "city_name": "Berlin", - "country_code": "DE", - "country_name": "Germany", - "continent_code": "EU", - "continent_name": "Europe", - "subdivisions": [ - { - "iso_code": "BE", - "name": "Land Berlin" - } - ] - }, - "asn": "6805", - "asn_name": "Telefonica Germany", - "asn_network": "2a02:3100::/24", - "asn_type": "isp", - "datacenter_result": false, - "datacenter_name": "" - } - }, - "ip_blocklist": { - "email_spam": false, - "attack_source": false, - "tor_node": false - }, - "proxy": true, - "proxy_confidence": "low", - "proxy_details": { - "proxy_type": "residential", - "last_seen_at": 1708102555327, - "provider": "Massive" - }, - "proxy_ml_score": 0.2, - "vpn": false, - "vpn_confidence": "high", - "vpn_ml_score": 0.2, - "vpn_origin_timezone": "Europe/Berlin", - "vpn_origin_country": "unknown", - "vpn_methods": { - "timezone_mismatch": false, - "public_vpn": false, - "auxiliary_mobile": false, - "os_mismatch": false, - "relay": false, - "ml_prediction": false - }, - "incognito": false, - "tampering": false, - "tampering_confidence": "high", - "tampering_ml_score": 0.3231, - "tampering_details": { - "anomaly_score": 0.1955, - "anti_detect_browser": false - }, - "cloned_app": false, - "factory_reset_timestamp": 0, - "jailbroken": false, - "simulator": false, - "frida": false, - "privacy_settings": false, - "virtual_machine": false, - "virtual_machine_ml_score": 0.2, - "location_spoofing": false, - "velocity": { - "distinct_ip": { - "5_minutes": 1, - "1_hour": 1, - "24_hours": 1 - }, - "distinct_linked_id": { - "5_minutes": 1, - "1_hour": 5, - "24_hours": 5 - }, - "distinct_country": { - "5_minutes": 1, - "1_hour": 2, - "24_hours": 2 - }, - "events": { - "5_minutes": 1, - "1_hour": 5, - "24_hours": 5 - }, - "ip_events": { - "5_minutes": 1, - "1_hour": 5, - "24_hours": 5 - }, - "distinct_ip_by_linked_id": { - "5_minutes": 1, - "1_hour": 5, - "24_hours": 5 - }, - "distinct_visitor_id_by_linked_id": { - "5_minutes": 1, - "1_hour": 5, - "24_hours": 5 - } - }, - "developer_tools": false, - "device_details": { - "device_manufacturer": "samsung", - "device_model": "SM-G991U", - "os_version": "13" - }, - "mitm_attack": false, - "sdk": { - "platform": "js", - "version": "3.11.10", - "integrations": [ - { - "name": "fingerprint-pro-react", - "version": "3.11.10", - "subintegration": { - "name": "preact", - "version": "10.21.0" - } - } - ] - }, - "replayed": false, - "high_activity_device": false, - "raw_device_attributes": { - "math": "5f030fa7d2e5f9f757bfaf81642eb1a6", - "vendor": "Google Inc.", - "plugins": [ - { - "description": "Portable Document Format", - "mimeTypes": [ - { - "suffixes": "pdf", - "type": "application/pdf" - }, - { - "suffixes": "pdf", - "type": "text/pdf" - } - ], - "name": "PDF Viewer" - } - ], - "webgl_extensions": { - "context_attributes": "6b1ed336830d2bc96442a9d76373252a", - "extension_parameters": "86a8abb36f0cb30b5946dec0c761d042", - "extensions": "57233d7b10f89fcd1ff95e3837ccd72d", - "parameters": "ea118c48e308bc4b0677118bbb3019ec", - "shader_precisions": "f223dfbcd580cf142da156d93790eb83", - "unsupported_extensions": [] - }, - "cookies_enabled": true, - "webgl_basics": { - "renderer": "WebKit WebGL", - "renderer_unmasked": "ANGLE (Apple, ANGLE Metal Renderer: Apple M4, Unspecified Version)", - "shading_language_version": "WebGL GLSL ES 1.0 (OpenGL ES GLSL ES 1.0 Chromium)", - "vendor": "WebKit", - "vendor_unmasked": "Google Inc. (Apple)", - "version": "WebGL 1.0 (OpenGL ES 2.0 Chromium)" - }, - "canvas": { - "geometry": "db3c1462576a399a03ae93d0ab9eb5c4", - "text": "70c3d3f7eb4408dc37a6bf8af1c51029", - "winding": true - }, - "hardware_concurrency": 10, - "languages": [ - [ - "en-US" - ] - ], - "color_depth": 24, - "fonts": [ - "Arial Unicode MS", - "Gill Sans", - "Helvetica Neue", - "Menlo" - ], - "indexed_db": true, - "touch_support": { - "max_touch_points": 0, - "touch_event": false, - "touch_start": false - }, - "device_memory": 8, - "oscpu": "Windows NT 6.1; Win64; x64", - "architecture": 127, - "screen_resolution": [ - 1920, - 1080 - ], - "timezone": "America/Sao_Paulo", - "emoji": { - "bottom": 32, - "font": "Times", - "height": 18, - "left": 8, - "right": 1608, - "top": 14, - "width": 1600, - "x": 8, - "y": 14 - }, - "font_preferences": { - "apple": 147.5625, - "default": 147.5625, - "min": 9.234375, - "mono": 133.0625, - "sans": 144.015625, - "serif": 147.5625, - "system": 146.09375 - }, - "platform": "MacIntel", - "local_storage": true, - "session_storage": true, - "date_time_locale": "en-US", - "audio": 124.04347745512496, - "keyboard_layout_hash": "691e3845c85c202a1514b6fd7ef17065", - "keyboard_layout_name": "en-US", - "battery_charging": true, - "battery_level": 80, - "battery_low_power_mode": true, - "timezone_offset": "-03:00", - "font_hash": "bb4d842593877975d45017c603ff5994", - "device_manufacturer": "samsung", - "device_model": "SM-S921U" - }, - "rare_device": false, - "rare_device_percentile_bucket": " Date: Mon, 16 Nov 2026 15:28:11 +0000 Subject: [PATCH 4/5] test: cover edge events in getEvent and searchEvents mocked tests --- .../getEventTests.spec.ts | 16 +++++++++++++- .../searchEventsTests.spec.ts | 21 +++++++++++++++++-- 2 files changed, 34 insertions(+), 3 deletions(-) diff --git a/tests/mocked-responses-tests/getEventTests.spec.ts b/tests/mocked-responses-tests/getEventTests.spec.ts index b05b95af..a5ed1c3b 100644 --- a/tests/mocked-responses-tests/getEventTests.spec.ts +++ b/tests/mocked-responses-tests/getEventTests.spec.ts @@ -1,6 +1,7 @@ import { ServerApiError, ErrorResponse, + EventEdge, FingerprintServerApiClient, Region, RequestError, @@ -8,10 +9,11 @@ import { } from '../../src' import getEventResponse from './mocked-responses-data/events/get_event_200.json' import getEventRulesetResponse from './mocked-responses-data/events/get_event_ruleset_200.json' +import getEventEdgeResponse from './mocked-responses-data/events/get_event_with_edge_200.json' import Error429 from './mocked-responses-data/errors/429_too_many_requests.json' import { createJsonResponse } from './utils' import { getIntegrationInfo } from '../../src/urlUtils' -import { describe, expect, it } from 'vitest' +import { describe, expect, expectTypeOf, it } from 'vitest' import { mockFetch } from './mockFetch' describe('[Mocked response] Get Event', () => { @@ -51,6 +53,18 @@ describe('[Mocked response] Get Event', () => { expect(response).toEqual(getEventRulesetResponse) }) + it('with an edge event', async () => { + mockFetch.mockReturnValue(Promise.resolve(createJsonResponse(getEventEdgeResponse))) + + const response = await client.getEvent(existingEventId) + + expect(response).toEqual(getEventEdgeResponse) + if (response.source !== 'edge') { + throw new Error(`Expected an edge event, got source: ${response.source}`) + } + expectTypeOf(response).toEqualTypeOf() + }) + it('403 error', async () => { const errorInfo = { error: { diff --git a/tests/mocked-responses-tests/searchEventsTests.spec.ts b/tests/mocked-responses-tests/searchEventsTests.spec.ts index a1e778b8..67f379a5 100644 --- a/tests/mocked-responses-tests/searchEventsTests.spec.ts +++ b/tests/mocked-responses-tests/searchEventsTests.spec.ts @@ -1,8 +1,9 @@ -import { ServerApiError, ErrorResponse, FingerprintServerApiClient, SearchEventsFilter } from '../../src' +import { ServerApiError, ErrorResponse, EventEdge, FingerprintServerApiClient, SearchEventsFilter } from '../../src' import getEventsSearch from './mocked-responses-data/events/search/get_event_search_200.json' +import getEventsSearchEdge from './mocked-responses-data/events/search/get_event_search_edge_200.json' import { createJsonResponse } from './utils' import { getIntegrationInfo } from '../../src/urlUtils' -import { describe, expect, it } from 'vitest' +import { describe, expect, expectTypeOf, it } from 'vitest' import { mockFetch } from './mockFetch' function expectedSearchEventsUrl(filters: NonNullable): string { @@ -25,6 +26,22 @@ describe('[Mocked response] Search Events', () => { const apiKey = 'dummy_api_key' const client = new FingerprintServerApiClient({ apiKey }) + it('with edge source', async () => { + mockFetch.mockReturnValue(Promise.resolve(createJsonResponse(getEventsSearchEdge))) + + const filter = { source: ['edge'] } satisfies SearchEventsFilter + const response = await client.searchEvents(filter) + + expect(mockFetch).toHaveBeenCalledWith(expectedSearchEventsUrl(filter), { + headers: { Authorization: `Bearer ${apiKey}` }, + method: 'GET', + }) + expect(response).toEqual(getEventsSearchEdge) + const edgeEvents = response.events.filter((event) => event.source === 'edge') + expect(edgeEvents).toHaveLength(response.events.length) + expectTypeOf(edgeEvents).toEqualTypeOf() + }) + it('without filter', async () => { mockFetch.mockReturnValue(Promise.resolve(createJsonResponse(getEventsSearch))) From deb95590511c99dd50d84460855c9667060b72f3 Mon Sep 17 00:00:00 2001 From: Juraj Uhlar Date: Mon, 16 Nov 2026 15:59:52 +0000 Subject: [PATCH 5/5] test: add source to sealed results fixture --- tests/unit-tests/__snapshots__/sealedResults.spec.ts.snap | 1 + tests/unit-tests/sealedResults.spec.ts | 4 ++-- 2 files changed, 3 insertions(+), 2 deletions(-) diff --git a/tests/unit-tests/__snapshots__/sealedResults.spec.ts.snap b/tests/unit-tests/__snapshots__/sealedResults.spec.ts.snap index 0b046536..b733f513 100644 --- a/tests/unit-tests/__snapshots__/sealedResults.spec.ts.snap +++ b/tests/unit-tests/__snapshots__/sealedResults.spec.ts.snap @@ -105,6 +105,7 @@ exports[`Unseal event response > unseals sealed data using aes256gcm 1`] = ` "platform": "js", "version": "3.11.10", }, + "source": "device", "supplementary_id_high_recall": { "confidence": { "score": 0.97, diff --git a/tests/unit-tests/sealedResults.spec.ts b/tests/unit-tests/sealedResults.spec.ts index 8ae8f0bd..0ce10d0d 100644 --- a/tests/unit-tests/sealedResults.spec.ts +++ b/tests/unit-tests/sealedResults.spec.ts @@ -17,7 +17,7 @@ describe('Parse events response', () => { describe('Unseal event response', () => { const sealedData = Buffer.from( - 'noXc7Xu7PIKu1tbMkMxLbQG4XU46Bv5dED98hqTkPYZnmb8PG81Q83Kpg541Vt4NQdkzfezDSVk8FP9ZzJ08L0MMb4S8bT78c10Op1LyKwZU6DGr1e3V+ZWcNzHVG1rPoL+eUHN6yR9MQp8/CmSUBQUPOOAUXdoqWohbfIGxoQIuQ5BtfpSJuYD6kTyswSi56wxzY/s24dMwgS2KnA81Y1pdi3ZVJKBdwGYGg4T5Dvcqu0GWv3sScKD9b4Tagfbe2m8nbXY/QtN770c7J1xo/TNXXdq4lyqaMyqIayHOwRBP58tNF8mACusm1pogOVIt456wIMetCGKxicPJr7m/Q02ONzhkMtzzXwgwriglGHfM7UbtTsCytCBP7J2vp0tEkHiq/X3qtuvSLJqNyRzwFJhgisKGftc5CIaT2VxVKKxkL/6Ws6FPm4sQB1UGtMCMftKpyb1lFzG9lwFkKvYN9+FGtvRM50mbrzz7ONDxbwykkxihAab36MIuk7dfhvnVLFAjrpuCkEFdWrtjVyWmM0xVeXpEUtP6Ijk5P+VuPZ1alV/JV1q4WvfrGMizEZbwbp6eQZg9mwKe4IX+FVi7sPF2S/CCLI/d90S5Yz6bBP9uiQ3pCVlYbVOkpwS0YQxnR+h5J50qodY7LuswNO5VlEgI0ztkjPQBr8koT4SM54X2z14tA2tKCxSv1psEL5HOk4IWN+9f3RVfDKBDruDiDd+BtZquhYLmOFat9K4h41NrPGAqv5tKmmJtx3llMs6LFHPKBlNlI5zgqE7T47xv2AWw5nqWM107t8lpRETIgJx+YN/Jv6byJSQm7afaeDtHXGceMPOKMziH1XgsiQiS56OsmyyRgaq5YCmMuaPw8gcgVa7RNZSafkP34aQBAuJOA3JFs5xcYcubKutD3h1mk697A8vwdtR/Gj0zTvuUnQ/9o3qHSLseAEIiY9/dS6WJnKXRKTonQi2F6DV9NTzFVQl99AH22jq6lIsjbEEKcq/ydFDUpgAq4lyp9nPBHuPXSojdG+1BWuUyjYykaqnLzzqKgRalGzeWmRHd2qeNw8Bz5OWYBw82C3gHRS2BB9VquIgEYktDvgJ5yRfDYkp8qgxHoYeR88ijccWgdvk+WH78OPdwqA7rqdAYcWqn9KNozoxuYddc0fnrHbgaWpanCmPp0gNEeb4r+i9FDGPSkgYBdyrEPHblsDN/Ad1dhLIHEDEtQyv13s6tDRgLVvhowrzqIM+5cm/abyTDhXzSYDfCw2Wf90cBOMsbQBB2N2YRqnrpA50PGp+0IwlPL7qZj1N4JGhvQD0ux8Ood6AiXpdguj7DMP+T0laHIjWee5/xGZB6g3EsCdOZJjVj7hSE/L3eV4No0WcLqJ5DPOgw+FnvQpxndCTc8DW83tNm624lm7scu0A499vEFj1dhtq5gUxsGcqzm09+Vk2V/d0sa77Xocqe3bcfS5lXc/pHrOc1qKlK8kTr2AYNwjeJJ14euuin361WBETd1I6n8eIs02HyBas09o9lT7Nq05jsnbxej6d0q6GH7IYusiBFTJaAZ6UXOV5i1NOcw9jaGyHms3M2N/b2cmXFYTIFZSjSfbqoI6YZF73sMPhEZqfZ5Jjq+ZLMC3A+yFPFJOW/0oolUGbcC8TBVmLi37Z9Wgc338w2Jf+I94SdViku', + 'noXc7bEdLlzJx56624i+YKrrNnCeA4bEF4ew1kUA8Yae7+E/SMA6aCyfJBe359ckVaD30umernyW4CyUvJ88OGDaB5AAN5J6VX2u74vl3jHXl5wJRPsBOiGXjh2rrZWF9BTyP/HxxAdxd6Ez8dsdF/5onjr5mszip7IeERdHJ7eIdLWfKUxC5SOOs3D0GhyFdLBJtMKrmk8B9EEi//7UIj5IETBCnL7NPhmuVWVaxWDSVGxDoCmXXHxGwPB1LeWdYlczxiTyIf6LIl6d4p9Q1oayk5x9j1b04m6LDqmjdQj+8ZwMPJpFWJpWJb1Z6SB/y4hql4kq6pQ0DKwsP6S47XPZb3U6cpIzMSGRh/E9JSTJQhW7jgjQdBnm7I4IxvN5nsCAX2EGYgR37MCAQeuSJs9vj5ZM8aZamzCN4RcDqBVjFZqdF9yAD53ZiVre+sadnCjWRbvkVBTKfzKJ7KjYmQftGn1l+W4ynHNg05+ksLAzsgwThQEH4/uLiIyKM4Qq2nFgaHtW9SBF07KniaeKRioc2lu+MFDCByGzpRVoLgrNAMmHBXES4IihVUuh0KHmtFuHE13x/4x2BZVyRMCKtfPAJ0kR9TDA7JZcR4JP1PP20KgqDyMMiDrDaHhyRqcOEmuwRVRCoARIqo0WmBBzRt7g8vQrCisPoJnbC/9NYlTjZWSu/0GEsKgpxKqAjXMppewREOiMKswZwQdj/Sn+Hs/seo0lhmetpb8nDvP6Ys67HAhVj/Uadi2rp6YpMI43e1ujV3FZCVNSGTKdzgHkq9d2kgo3bKwtSCTMwd+k/8vkdeNZnnyvewyt7ZGmzKZNCDGRE2xjLqKviiw4UALVbKA8/ZiQTWX21387Mc3jq18KD1fZjvTEF2pMVoCxXttyC1Wt8rd4esL3bPcpp1R0HbFyWp+nKJDKFUrfQ5040ru94h5t5/DpozGgEE4A4kVhH6sdX3JqRUWe2kEPo/2CPkTXFcRS3qTs70SDW0wvk5B5LgR54BlkAd++CBlgg8fpxNsw9L8BdQqIaqQv4PaEKOcURpRn9ULDtfsW89dCXgcJnesirG22Mn+Ly6MH1f8paX59ZS2n1cPvvMkposgj2cIrfQJUoBlqoSI4Dp0qB7IDk7oD/ggZujTRYhwDrvInQDGSTybanwsfw2F78rSLeE/aKaKfUj2olHg9uD6bfkY+EZR9who+Qlr+PEp2I4qGf2NZFAD5TduQGveo864cYbWBZWoHg5GJ43fLmOwVfW5ZxByGCBseeYid80H05YWI+Etz5YxJfkYHI4oqJ3U4zrEtyWgryvCK6CvStHW820H0C77IE2ZAlh0mHXPUSV0UzoE+GaPLYIMk5TnhlYAd5H9Lg5Ggj01sxNdKRfmx/9hAUp3aOmeZ7N3PZYa07SoRvAkf5IAwVZqbT5i155jMXQ0oicyUvDC7+dHKjckbTCP8WhUadQPd5xRCCPJ7LWOXzNV6N/3zhIRNZ0Y5szQXWp/bTV1BY0lvpYpm1FIC0T2+mhBZeqhZSXPR3yD65lg71fysQlFJvsE9gNAYO82motGxhuUzb/pb9Zdrk/Kwb6N4DnqgryXsb4pj7D9HoIEz6HPkPK0FMx5MNgpAZiz63eU4U8MrxfgCy8iry6NTz2KXdbE8RwM5Ehrw', 'base64' ) const validKey = Buffer.from('p2PA7MGy5tx56cnyJaFZMr96BCFwZeHjZV2EqMvTq53=', 'base64') @@ -35,7 +35,7 @@ describe('Unseal event response', () => { }, ]) - expect(result).toBeTruthy() + expect(result.source).toBe('device') expect(result).toMatchSnapshot() })