@bytexbyte/berify-analytics-api 2.2.6 → 2.2.8

package/lib/berifyAnalyticsApi/src/Heatmap/index.js

@@ -4,18 +4,19 @@ const bxb_api_1 = require("@bytexbyte/bxb-api");
 class BerifyHeatMapApi extends bxb_api_1.default {
     constructor({ host, secretKey, secret }) {
         super({
-            host, moduleName: 'heatmap',
+            host,
+            moduleName: 'heatmap',
             secretKey: secretKey ?? 'secretKey',
-            secret: secret ?? 'secret'
+            secret: secret ?? 'secret',
         });
     }
     async getHeatmap(form) {
         const response = await this.bxbFetch({
             method: 'POST',
             headers: {
-                'Content-Type': 'application/json'
+                'Content-Type': 'application/json',
             },
-            body: JSON.stringify(form)
+            body: JSON.stringify(form),
         });
         return response.json();
     }
@@ -23,8 +24,8 @@ class BerifyHeatMapApi extends bxb_api_1.default {
         const response = await this.bxbFetch({
             method: 'GET',
             headers: {
-                'Content-Type': 'application/json'
-            }
+                'Content-Type': 'application/json',
+            },
         });
         return response.json();
     }
@@ -32,9 +33,9 @@ class BerifyHeatMapApi extends bxb_api_1.default {
         const response = await this.bxbFetch({
             method: 'POST',
             headers: {
-                'Content-Type': 'application/json'
+                'Content-Type': 'application/json',
             },
-            body: JSON.stringify(form)
+            body: JSON.stringify(form),
         }, 'date-range');
         return response.json();
     }

package/lib/berifyAnalyticsApi/src/Heatmap/type.d.ts

@@ -1,5 +1,4 @@
-import { Decimal } from "@prisma/client/runtime/library";
-import { ScanType } from "../../../interfaces";
+import { ScanType } from '../../../interfaces';
 export type HeatmapApi = (form: HeatmapRequest) => Promise<HeatmapResponse>;
 declare enum TimeInterval {
     All = "All Time",
@@ -8,6 +7,12 @@ declare enum TimeInterval {
     LastWeek = "Last week",
     LastMonth = "Last month"
 }
+export type HeatmapBounds = {
+    minLat: number;
+    maxLat: number;
+    minLng: number;
+    maxLng: number;
+};
 export type HeatmapRequest = {
     userId: string;
     companyId?: string;
@@ -16,6 +21,13 @@ export type HeatmapRequest = {
     collectionRuleId?: string;
     timeInterval: TimeInterval;
     scanTypes?: ScanType[] | ScanType;
+    /** Map viewport; scans outside it are not aggregated. Omitted means worldwide. */
+    bounds?: HeatmapBounds;
+    /** Explicit window; overrides timeInterval so the client owns its presets. */
+    from?: string | Date;
+    to?: string | Date;
+    /** 'compact' returns [lat, lng, count] tuples instead of objects. */
+    format?: 'objects' | 'compact';
 };
 export type ReskinHeatmapRequest = {
     userId: string;
@@ -26,14 +38,36 @@ export type ReskinHeatmapRequest = {
     startDate: Date;
     endDate: Date;
 };
-export type HeatmapResult = {
-    id: string;
-    latitude: Decimal | null;
-    longitude: Decimal | null;
-}[];
+/** One scan, at the place it happened. Sent while the viewport holds few enough. */
+export type HeatmapPoint = {
+    count: number;
+    lat: number;
+    lng: number;
+};
+/** A bucket of scans at the centre of its h3 cell, for views too broad to send raw. */
+export type HeatmapCell = HeatmapPoint & {
+    h3: string;
+};
+export type HeatmapMode = 'points' | 'cells';
+export type HeatmapResult = HeatmapPoint[] | HeatmapCell[] | HeatmapTuple[];
+export type HeatmapTuple = [lat: number, lng: number, count: number];
+export type HeatmapMeta = {
+    /** Which shape `data` is in — see HeatmapRequest.format. */
+    encoding: 'objects' | 'compact';
+    /** 'points' means data is raw scans; 'cells' means it is h3 buckets. */
+    mode: HeatmapMode;
+    /** h3 resolution of the buckets, null in 'points' mode. */
+    resolution: number | null;
+    /** Scans matching the filter, before anything geographic is applied. */
+    totalPoints: number;
+    cellCount: number;
+    /** Scans with no usable coordinates — they cannot appear at any zoom. */
+    withoutLocation: number;
+};
 export type HeatmapResponse = {
     status: 'ok' | 'error';
     data?: HeatmapResult;
+    meta?: HeatmapMeta;
     error?: string;
 };
 export type LastUpdatedAtResponse = {

package/lib/berifyAnalyticsApi/src/Report/index.js

@@ -7,7 +7,7 @@ class BerifyReportApi extends bxb_api_1.default {
             host,
             moduleName: 'reports',
             secretKey: secretKey ?? 'secretKey',
-            secret: secret ?? 'secret'
+            secret: secret ?? 'secret',
         });
     }
     /**
@@ -22,9 +22,9 @@ class BerifyReportApi extends bxb_api_1.default {
         const response = await this.bxbFetch({
             method: 'POST',
             headers: {
-                'Content-Type': 'application/json'
+                'Content-Type': 'application/json',
             },
-            body: JSON.stringify({ user, ...form })
+            body: JSON.stringify({ user, ...form }),
         }, '');
         return response.json();
     }

package/lib/berifyAnalyticsApi/src/Reskin/index.js

@@ -4,18 +4,19 @@ const bxb_api_1 = require("@bytexbyte/bxb-api");
 class BerifyReskinApi extends bxb_api_1.default {
     constructor({ host, secretKey, secret }) {
         super({
-            host, moduleName: 'reskin',
+            host,
+            moduleName: 'reskin',
             secretKey: secretKey ?? 'secretKey',
-            secret: secret ?? 'secret'
+            secret: secret ?? 'secret',
         });
     }
     async getScanCount(user, form) {
         const response = await this.bxbFetch({
             method: 'POST',
             headers: {
-                'Content-Type': 'application/json'
+                'Content-Type': 'application/json',
             },
-            body: JSON.stringify({ user, form })
+            body: JSON.stringify({ user, form }),
         }, 'scan-count');
         return response.json();
     }
@@ -23,9 +24,9 @@ class BerifyReskinApi extends bxb_api_1.default {
         const response = await this.bxbFetch({
             method: 'POST',
             headers: {
-                'Content-Type': 'application/json'
+                'Content-Type': 'application/json',
             },
-            body: JSON.stringify({ user, form })
+            body: JSON.stringify({ user, form }),
         }, 'new-user-count');
         return response.json();
     }
@@ -33,9 +34,9 @@ class BerifyReskinApi extends bxb_api_1.default {
         const response = await this.bxbFetch({
             method: 'POST',
             headers: {
-                'Content-Type': 'application/json'
+                'Content-Type': 'application/json',
             },
-            body: JSON.stringify({ user, form })
+            body: JSON.stringify({ user, form }),
         }, 'unique-scan-count');
         return response.json();
     }
@@ -43,9 +44,9 @@ class BerifyReskinApi extends bxb_api_1.default {
         const response = await this.bxbFetch({
             method: 'POST',
             headers: {
-                'Content-Type': 'application/json'
+                'Content-Type': 'application/json',
             },
-            body: JSON.stringify({ user, form })
+            body: JSON.stringify({ user, form }),
         }, 'session-duration-avg');
         return response.json();
     }
@@ -53,9 +54,9 @@ class BerifyReskinApi extends bxb_api_1.default {
         const response = await this.bxbFetch({
             method: 'POST',
             headers: {
-                'Content-Type': 'application/json'
+                'Content-Type': 'application/json',
             },
-            body: JSON.stringify({ user, form })
+            body: JSON.stringify({ user, form }),
         }, 'promo-modal-open-count');
         return response.json();
     }
@@ -63,9 +64,9 @@ class BerifyReskinApi extends bxb_api_1.default {
         const response = await this.bxbFetch({
             method: 'POST',
             headers: {
-                'Content-Type': 'application/json'
+                'Content-Type': 'application/json',
             },
-            body: JSON.stringify({ user, form })
+            body: JSON.stringify({ user, form }),
         }, 'community-modal-open-count');
         return response.json();
     }
@@ -73,9 +74,9 @@ class BerifyReskinApi extends bxb_api_1.default {
         const response = await this.bxbFetch({
             method: 'POST',
             headers: {
-                'Content-Type': 'application/json'
+                'Content-Type': 'application/json',
             },
-            body: JSON.stringify({ user, form })
+            body: JSON.stringify({ user, form }),
         }, 'bounce-rate');
         return response.json();
     }
@@ -83,9 +84,9 @@ class BerifyReskinApi extends bxb_api_1.default {
         const response = await this.bxbFetch({
             method: 'POST',
             headers: {
-                'Content-Type': 'application/json'
+                'Content-Type': 'application/json',
             },
-            body: JSON.stringify({ user, form })
+            body: JSON.stringify({ user, form }),
         }, 'experience-engagement');
         return response.json();
     }
@@ -93,9 +94,9 @@ class BerifyReskinApi extends bxb_api_1.default {
         const response = await this.bxbFetch({
             method: 'POST',
             headers: {
-                'Content-Type': 'application/json'
+                'Content-Type': 'application/json',
             },
-            body: JSON.stringify({ user, form })
+            body: JSON.stringify({ user, form }),
         }, 'gender-breakdown');
         return response.json();
     }
@@ -103,9 +104,9 @@ class BerifyReskinApi extends bxb_api_1.default {
         const response = await this.bxbFetch({
             method: 'POST',
             headers: {
-                'Content-Type': 'application/json'
+                'Content-Type': 'application/json',
             },
-            body: JSON.stringify({ user, form })
+            body: JSON.stringify({ user, form }),
         }, 'age-distribution');
         return response.json();
     }
@@ -113,9 +114,9 @@ class BerifyReskinApi extends bxb_api_1.default {
         const response = await this.bxbFetch({
             method: 'POST',
             headers: {
-                'Content-Type': 'application/json'
+                'Content-Type': 'application/json',
             },
-            body: JSON.stringify({ user, form })
+            body: JSON.stringify({ user, form }),
         }, 'device-type');
         return response.json();
     }
@@ -123,9 +124,9 @@ class BerifyReskinApi extends bxb_api_1.default {
         const response = await this.bxbFetch({
             method: 'POST',
             headers: {
-                'Content-Type': 'application/json'
+                'Content-Type': 'application/json',
             },
-            body: JSON.stringify({ user, form })
+            body: JSON.stringify({ user, form }),
         }, 'heatmap');
         return response.json();
     }
@@ -133,9 +134,9 @@ class BerifyReskinApi extends bxb_api_1.default {
         const response = await this.bxbFetch({
             method: 'POST',
             headers: {
-                'Content-Type': 'application/json'
+                'Content-Type': 'application/json',
             },
-            body: JSON.stringify({ user, form })
+            body: JSON.stringify({ user, form }),
         }, 'daily-scan-count');
         return response.json();
     }
@@ -143,9 +144,9 @@ class BerifyReskinApi extends bxb_api_1.default {
         const response = await this.bxbFetch({
             method: 'POST',
             headers: {
-                'Content-Type': 'application/json'
+                'Content-Type': 'application/json',
             },
-            body: JSON.stringify({ user, form })
+            body: JSON.stringify({ user, form }),
         }, 'active-time');
         return response.json();
     }

package/lib/berifyAnalyticsApi/src/Reskin/type.d.ts

@@ -1,4 +1,4 @@
-import { Decimal } from "@prisma/client/runtime/library";
+import { Decimal } from '@prisma/client/runtime/library';
 export type CompanyRoleType = 'super' | 'admin' | 'marketing' | 'supplier' | 'seo' | 'associate';
 export type User = {
     id: string;

package/lib/berifyAnalyticsApi/src/ScanChart/index.d.ts

@@ -10,7 +10,7 @@ declare class BerifyScanChartApi extends BxBApi {
     getUserReport(user: User, form: UserReportRequest): Promise<UserReportResponse>;
     getScanRateAll(user: User, form: UserReportRequest): Promise<ScanRateResponse>;
     getScanRateByTime(user: User, form: ScanRateByTimeRequest): Promise<ScanRateByTimeResponse>;
-    getBatchScanData(form: BatchScanDataRequest): Promise<BatchScanDataResponse>;
+    getBatchScanData(user: User, form: BatchScanDataRequest): Promise<BatchScanDataResponse>;
     getLeaderBoard(user: User, form: LeaderBoardRequest): Promise<LeaderBoardResponse>;
     getTagScanHistory(form: TagSearchRequest): Promise<TagScanResponse>;
     exportBatchScannedUsers(user: User, form: BatchScannedUsersExportRequest): Promise<BatchScannedUsersExportResponse>;

package/lib/berifyAnalyticsApi/src/ScanChart/index.js

@@ -4,18 +4,19 @@ const bxb_api_1 = require("@bytexbyte/bxb-api");
 class BerifyScanChartApi extends bxb_api_1.default {
     constructor({ host, secretKey, secret }) {
         super({
-            host, moduleName: 'scan-chart',
+            host,
+            moduleName: 'scan-chart',
             secretKey: secretKey ?? 'secretKey',
-            secret: secret ?? 'secret'
+            secret: secret ?? 'secret',
         });
     }
     async getScanReport(user, form) {
         const response = await this.bxbFetch({
             method: 'POST',
             headers: {
-                'Content-Type': 'application/json'
+                'Content-Type': 'application/json',
             },
-            body: JSON.stringify({ user, form })
+            body: JSON.stringify({ user, form }),
         }, 'scan-report');
         return response.json();
     }
@@ -23,9 +24,9 @@ class BerifyScanChartApi extends bxb_api_1.default {
         const response = await this.bxbFetch({
             method: 'POST',
             headers: {
-                'Content-Type': 'application/json'
+                'Content-Type': 'application/json',
             },
-            body: JSON.stringify({ user, form })
+            body: JSON.stringify({ user, form }),
         }, 'user-report');
         return response.json();
     }
@@ -33,9 +34,9 @@ class BerifyScanChartApi extends bxb_api_1.default {
         const response = await this.bxbFetch({
             method: 'POST',
             headers: {
-                'Content-Type': 'application/json'
+                'Content-Type': 'application/json',
             },
-            body: JSON.stringify({ user, form })
+            body: JSON.stringify({ user, form }),
         }, 'scan-rate-all');
         return response.json();
     }
@@ -43,19 +44,19 @@ class BerifyScanChartApi extends bxb_api_1.default {
         const response = await this.bxbFetch({
             method: 'POST',
             headers: {
-                'Content-Type': 'application/json'
+                'Content-Type': 'application/json',
             },
-            body: JSON.stringify({ user, form })
+            body: JSON.stringify({ user, form }),
         }, 'scan-rate-by-time');
         return response.json();
     }
-    async getBatchScanData(form) {
+    async getBatchScanData(user, form) {
         const response = await this.bxbFetch({
             method: 'POST',
             headers: {
-                'Content-Type': 'application/json'
+                'Content-Type': 'application/json',
             },
-            body: JSON.stringify({ form })
+            body: JSON.stringify({ user, form }),
         }, 'batch-scan-data');
         return response.json();
     }
@@ -63,9 +64,9 @@ class BerifyScanChartApi extends bxb_api_1.default {
         const response = await this.bxbFetch({
             method: 'POST',
             headers: {
-                'Content-Type': 'application/json'
+                'Content-Type': 'application/json',
             },
-            body: JSON.stringify({ user, form })
+            body: JSON.stringify({ user, form }),
         }, 'leaderBoard');
         return response.json();
     }
@@ -73,9 +74,9 @@ class BerifyScanChartApi extends bxb_api_1.default {
         const response = await this.bxbFetch({
             method: 'POST',
             headers: {
-                'Content-Type': 'application/json'
+                'Content-Type': 'application/json',
             },
-            body: JSON.stringify({ form })
+            body: JSON.stringify({ form }),
         }, 'tagScanHistory');
         return response.json();
     }

package/lib/berifyAnalyticsApi/src/ScanChart/type.d.ts

@@ -1,4 +1,4 @@
-import { Scan, ScanType } from "../../../interfaces";
+import { Scan, ScanType } from '../../../interfaces';
 export type ScanReportRequest = {
     tagId?: string;
     batchId?: string;

package/lib/berifyAnalyticsApi/src/index.d.ts

@@ -1,7 +1,7 @@
-import BerifyHeatMapApi from "./Heatmap";
-import BerifyReskinApi from "./Reskin";
-import BerifyScanChartApi from "./ScanChart";
-import BerifyReportApi from "./Report";
+import BerifyHeatMapApi from './Heatmap';
+import BerifyReskinApi from './Reskin';
+import BerifyScanChartApi from './ScanChart';
+import BerifyReportApi from './Report';
 declare class BerifyAnalyticsApi {
     host: string;
     secretKey?: string;

package/lib/interfaces/index.d.ts

@@ -28,6 +28,7 @@ export interface Scan {
     location: string | null;
     createdAt: Date;
     tagId: string;
+    batchId: string | null;
     generalUserId: string;
     isVisitedPromo: boolean;
     isVisitedShop: boolean;
@@ -39,12 +40,12 @@ export interface Scan {
     type: ScanType;
     tag: {
         tokenId: string;
-        batchId: string;
-        batch: {
-            companyId: string;
-            name: string;
-        };
+        batchId?: string | null;
     };
+    batch: {
+        companyId: string;
+        name: string;
+    } | null;
 }
 export type DataWithDate = {
     date: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bytexbyte/berify-analytics-api",
-  "version": "2.2.6",
+  "version": "2.2.8",
   "description": "api",
   "main": "lib/berifyAnalyticsApi/src/index.js",
   "types": "lib/berifyAnalyticsApi/src/index.d.ts",