OpenAPI schema sync (v3.3.0)

.changeset/beige-places-drop.md

@@ -0,0 +1,5 @@
+---
+'@fingerprint/node-sdk': patch
+---
+
+**events**: Clarify availability of proxy and VM ML score signals

.changeset/blue-roses-film.md

@@ -0,0 +1,5 @@
+---
+'@fingerprint/node-sdk': patch
+---
+
+**events**: Clarify semantics of `incremental_identification_status`

.changeset/curvy-rice-chew.md

@@ -0,0 +1,5 @@
+---
+'@fingerprint/node-sdk': patch
+---
+
+**visitors**: Clarify rate limits for `deleteVisitorData` operation

.changeset/developer-tools-mobile-platforms.md

@@ -0,0 +1,5 @@
+---
+'@fingerprint/node-sdk': minor
+---
+
+**events**: Add Android and iOS platform support to `developer_tools` smart signal

.changeset/fancy-spiders-flash.md

@@ -0,0 +1,5 @@
+---
+'@fingerprint/node-sdk': minor
+---
+
+**events**: Add `labels` to `Event`

.changeset/loud-donuts-lead.md

@@ -0,0 +1,5 @@
+---
+'@fingerprint/node-sdk': patch
+---
+
+**events-search**: Clarify availability of `rare_device` and `rare_device_percentile_bucket` query parameters

.changeset/openapi-v3.3-breaking-types.md

@@ -0,0 +1,9 @@
+---
+'@fingerprint/node-sdk': minor
+---
+
+**types**: Type-breaking changes in generated TypeScript types for OpenAPI v3.3.0:
+
+- `SearchEventsFilter.start` and `SearchEventsFilter.end` are now `number | string` (RFC3339 strings in addition to Unix milliseconds)
+- `BotInfo.category` is now `BotInfoCategory` instead of `string`. Update assignments, comparisons, and narrowing that assumed a free-form string.
+- `BotInfoCategory` includes new enum members such as `unknown` (exhaustive `switch` statements may need updates)

.changeset/pre.json

@@ -0,0 +1,8 @@
+{
+  "mode": "pre",
+  "tag": "test",
+  "initialVersions": {
+    "@fingerprint/node-sdk": "7.2.0"
+  },
+  "changesets": []
+}

.changeset/wet-socks-fold.md

@@ -0,0 +1,5 @@
+---
+'@fingerprint/node-sdk': patch
+---
+
+**events-search**: Fix `pagination_key` example

.changeset/witty-lions-worry.md

@@ -0,0 +1,5 @@
+---
+'@fingerprint/node-sdk': minor
+---
+
+**events-search**: Add `bot_info` filter parameters

.github/workflows/build.yml

@@ -8,5 +8,3 @@ jobs:
   build-and-check:
     name: Build project and run CI checks
     uses: fingerprintjs/dx-team-toolkit/.github/workflows/build-typescript-project.yml@v1
-
-

.schema-version

@@ -1 +1 @@
-v3.2.0
+v3.3.0

example/deleteVisitor.mjs

@@ -1,3 +1,4 @@
+// @ts-check
 import { FingerprintServerApiClient, Region, RequestError } from '@fingerprint/node-sdk'
 import { config } from 'dotenv'
 config()

example/getEvent.mjs

@@ -1,3 +1,4 @@
+// @ts-check
 import { FingerprintServerApiClient, Region, RequestError } from '@fingerprint/node-sdk'
 import { config } from 'dotenv'
 config()

example/searchEvents.mjs

@@ -1,3 +1,4 @@
+// @ts-check
 import { FingerprintServerApiClient, Region, RequestError } from '@fingerprint/node-sdk'
 import { config } from 'dotenv'
 config()
@@ -19,17 +20,22 @@ if (envRegion === 'eu') {
 
 const client = new FingerprintServerApiClient({ region, apiKey })
 
+/** @type {import('@fingerprint/node-sdk').SearchEventsFilter} */
 const filter = {
   limit: 10,
   // pagination_key: '<pagination_key>',
   // bot: 'all',
   // visitor_id: 'TaDnMBz9XCpZNuSzFUqP',
   // ip_address: '192.168.0.1/32',
   // linked_id: '<linked_id>',
-  //start: 1620000000000,
-  //end: 1630000000000,
-  //reverse: true,
-  //suspect: false,
+  // // Unix milliseconds:
+  // start: 1620000000000,
+  // end: 1630000000000,
+  // // RFC3339 timestamps (alternative to Unix ms):
+  // // start: '2026-01-01T00:00:00Z',
+  // // end: '2026-01-31T23:59:59Z',
+  // reverse: true,
+  // suspect: false,
 }
 
 try {

example/tsconfig.json

@@ -0,0 +1,13 @@
+{
+  "extends": "../tsconfig.json",
+  "compilerOptions": {
+    "allowJs": true,
+    "checkJs": true,
+    "noEmit": true,
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "lib": ["ES2022"],
+    "types": ["node"]
+  },
+  "include": ["*.mjs"]
+}

example/unsealResult.mjs

@@ -1,3 +1,4 @@
+// @ts-check
 import { unsealEventsResponse, DecryptionAlgorithm } from '@fingerprint/node-sdk'
 import { config } from 'dotenv'
 config()

example/updateEvent.mjs

@@ -1,3 +1,4 @@
+// @ts-check
 import { FingerprintServerApiClient, RequestError, Region } from '@fingerprint/node-sdk'
 import { config } from 'dotenv'
 
@@ -28,11 +29,11 @@ const client = new FingerprintServerApiClient({ region, apiKey })
 
 try {
   await client.updateEvent(eventId, {
-      tags: {
-        key: 'value',
-      },
-      linked_id: 'new_linked_id',
-      suspect: false,
+    tags: {
+      key: 'value',
+    },
+    linked_id: 'new_linked_id',
+    suspect: false,
   })
 
   console.log('Event updated')

example/validateWebhookSignature.mjs

@@ -1,3 +1,4 @@
+// @ts-check
 import { isValidWebhookSignature } from '@fingerprint/node-sdk'
 
 /**

package.json

@@ -27,11 +27,13 @@
   "scripts": {
     "prepare": "husky install",
     "build": "rimraf dist && rollup -c rollup.config.js --bundleConfigAsCjs",
-    "lint": "eslint --ext .js,.ts --ignore-path .gitignore --max-warnings 0 .",
+    "lint": "eslint --ext .js,.ts,.mjs --ignore-path .gitignore --max-warnings 0 .",
     "lint:fix": "pnpm lint --fix",
+    "typecheck:source": "tsc --noEmit -p tsconfig.json",
+    "typecheck:examples": "tsc --noEmit -p example/tsconfig.json",
     "test": "jest",
     "test:coverage": "jest --coverage",
-    "test:dts": "tsc --noEmit --isolatedModules dist/index.d.ts",
+    "test:dts": "tsc --noEmit --isolatedModules dist/index.d.ts && pnpm typecheck:examples",
     "generateTypes": "node generate.mjs && pnpm lint:fix",
     "docs": "typedoc src/index.ts --out docs"
   },