@hiver/connector-admin 4.19.0 → 4.19.1-appsEventTracking-beta.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hiver/connector-admin",
-  "version": "4.19.0",
+  "version": "4.19.1-appsEventTracking-beta.0",
   "main": "index.es.js",
   "module": "index.es.js",
   "types": "index.d.ts",

package/v2/app/connectors/pages/api-view/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/v2/app/connectors/pages/api-view/index.tsx"],"names":[],"mappings":"AAgCA,eAAO,MAAM,OAAO,+CAgGnB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/v2/app/connectors/pages/api-view/index.tsx"],"names":[],"mappings":"AAiCA,eAAO,MAAM,OAAO,+CA0GnB,CAAC"}

package/v2/app/connectors/pages/app-detail/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/v2/app/connectors/pages/app-detail/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAgD,MAAM,OAAO,CAAC;AAwBzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAqC9C,UAAU,kBAAkB;IAC1B;;;;;;OAMG;IACH,IAAI,EAAE,aAAa,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,aAAa,EAAE,EAAE,CAAC,kBAAkB,CAgGhD,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/v2/app/connectors/pages/app-detail/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAgD,MAAM,OAAO,CAAC;AA0BzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAqC9C,UAAU,kBAAkB;IAC1B;;;;;;OAMG;IACH,IAAI,EAAE,aAAa,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,aAAa,EAAE,EAAE,CAAC,kBAAkB,CA0GhD,CAAC"}

package/v2/app/connectors/pages/auth-success/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/v2/app/connectors/pages/auth-success/index.tsx"],"names":[],"mappings":"AASA,eAAO,MAAM,WAAW,+CA8BvB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/v2/app/connectors/pages/auth-success/index.tsx"],"names":[],"mappings":"AAWA,eAAO,MAAM,WAAW,+CAyCvB,CAAC"}

package/v2/app/connectors/pages/initial-setup/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/v2/app/connectors/pages/initial-setup/index.tsx"],"names":[],"mappings":"AA2BA,eAAO,MAAM,YAAY,+CA8FxB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/v2/app/connectors/pages/initial-setup/index.tsx"],"names":[],"mappings":"AA4BA,eAAO,MAAM,YAAY,+CAqGxB,CAAC"}

package/v2/constants/gainsight.d.ts

@@ -38,7 +38,21 @@ export declare const GAINSIGHTEVENT: {
     LOOKUP_SAVED: string;
     FIELD_MAP_BUTTON_CLICKED: string;
     FIELD_MAP_CONFIG_SAVED: string;
+    APP_ONBOARDING_PAGE_VISITED: string;
 };
+/**
+ * The `page` values carried by `app_onboarding_page_visited` — one per step of
+ * the Apps onboarding journey. Kept here rather than inlined at the call sites
+ * so the vocabulary analysts query cannot drift page by page.
+ */
+export declare const GAINSIGHT_ONBOARDING_PAGES: {
+    readonly TEMPLATE_APP: "template_app";
+    readonly APP_DETAIL: "app_detail";
+    readonly API_VIEW: "api_view";
+    readonly INITIAL_SETUP: "initial_setup";
+    readonly AUTH_SUCCESS: "auth_success";
+};
+export type GainsightOnboardingPage = (typeof GAINSIGHT_ONBOARDING_PAGES)[keyof typeof GAINSIGHT_ONBOARDING_PAGES];
 export declare const GAINSIGHT_CONSTANTS: {
     AUTH_PAGE: string;
     DETAILS_PAGE: string;

package/v2/constants/gainsight.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gainsight.d.ts","sourceRoot":"","sources":["../../../src/v2/constants/gainsight.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwC1B,CAAC;AAEF,eAAO,MAAM,mBAAmB;;;;CAI/B,CAAC"}
+{"version":3,"file":"gainsight.d.ts","sourceRoot":"","sources":["../../../src/v2/constants/gainsight.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyC1B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,0BAA0B;;;;;;CAM7B,CAAC;AAEX,MAAM,MAAM,uBAAuB,GAAG,CAAC,OAAO,0BAA0B,CAAC,CAAC,MAAM,OAAO,0BAA0B,CAAC,CAAC;AAEnH,eAAO,MAAM,mBAAmB;;;;CAI/B,CAAC"}

package/v2/hooks/__tests__/use-onboarding-page-visited.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=use-onboarding-page-visited.test.d.ts.map

package/v2/hooks/__tests__/use-onboarding-page-visited.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-onboarding-page-visited.test.d.ts","sourceRoot":"","sources":["../../../../src/v2/hooks/__tests__/use-onboarding-page-visited.test.tsx"],"names":[],"mappings":""}

package/v2/hooks/use-onboarding-page-visited.d.ts

@@ -0,0 +1,36 @@
+import { GainsightOnboardingPage } from '../constants/gainsight';
+import { ISendTrackingEventData } from '../types/app';
+interface IUseOnboardingPageVisitedParams {
+    /** Which step of the onboarding journey this page is. */
+    page: GainsightOnboardingPage;
+    /** Page-specific identifiers (`connector_id` / `template_id`) merged into the payload. */
+    data?: ISendTrackingEventData;
+    /**
+     * Set to false while the page does not yet know it is the one being shown —
+     * `api-view` and `app-detail` redirect to each other depending on whether the
+     * app's type is registered, and a funnel step must not be counted twice.
+     * Rules of hooks mean the hook is always called; this gates the emit instead.
+     */
+    enabled?: boolean;
+}
+/**
+ * Fires `app_onboarding_page_visited` once per visit to an onboarding page.
+ *
+ * "Once per visit", not once per session: the guard is a ref on this hook's own
+ * instance, so it survives re-renders and a late connector load, and navigating
+ * away and back mounts a fresh instance that fires again.
+ *
+ * `total_apps_activated` is read from `getPITConnectorStats` at emit time — the
+ * same helper the dashboard spreads into `connector_section_viewed` and the
+ * Gainsight identify attributes, so the two can never disagree.
+ *
+ * The connector list is only waited on while it is actually in flight, so a page
+ * that never fetches it — `auth-success` renders in the OAuth popup, a fresh app
+ * instance where nobody dispatches `fetchConnectors` — still emits its funnel
+ * step. What it does NOT do is claim a count it never had: `total_apps_activated`
+ * is omitted unless the list actually loaded, because a fabricated 0 cannot be
+ * told apart from a real one and analytics cannot be backfilled.
+ */
+export declare const useOnboardingPageVisited: ({ page, data, enabled }: IUseOnboardingPageVisitedParams) => void;
+export {};
+//# sourceMappingURL=use-onboarding-page-visited.d.ts.map

package/v2/hooks/use-onboarding-page-visited.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-onboarding-page-visited.d.ts","sourceRoot":"","sources":["../../../src/v2/hooks/use-onboarding-page-visited.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACxE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAE7D,UAAU,+BAA+B;IACvC,yDAAyD;IACzD,IAAI,EAAE,uBAAuB,CAAC;IAC9B,0FAA0F;IAC1F,IAAI,CAAC,EAAE,sBAAsB,CAAC;IAC9B;;;;;OAKG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,wBAAwB,4BAAoC,+BAA+B,KAAG,IA4C1G,CAAC"}

package/v2/utils/__tests__/get-pit-connector-stats.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=get-pit-connector-stats.test.d.ts.map

package/v2/utils/__tests__/get-pit-connector-stats.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-pit-connector-stats.test.d.ts","sourceRoot":"","sources":["../../../../src/v2/utils/__tests__/get-pit-connector-stats.test.ts"],"names":[],"mappings":""}

package/v2/utils/index.d.ts

@@ -53,6 +53,7 @@ export declare const devLogger: {
 export declare const getPITConnectorStats: (connectorsObj: Record<string, IConnectorDetails>) => {
     total_authenticated_apps: number;
     total_enabled_apps: number;
+    total_apps_activated: number;
     total_apps_setup: number;
     apps_list: string;
     apps_auth_status: Record<string, boolean>;

package/v2/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/v2/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAU5D,OAAO,KAAK,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACxE,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE/E,KAAK,UAAU,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;AAEpD,wBAAgB,UAAU,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,MAAM,GAAG;IAAE,CAAC,CAAC,EAAE,MAAM,GAAG,CAAC,CAAA;CAAE,CAStF;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,MAAM,YAEhE;AAED,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC,CAQjH;AACD;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,sBAAuB,aAAa,2BAAoB,MAAM,YAM5F,CAAC;AAEF,eAAO,MAAM,aAAa,sBAAuB,aAAa,YAK7D,CAAC;AAEF,eAAO,MAAM,YAAY,sBAAuB,aAAa,YACG,CAAC;AAEjE,eAAO,MAAM,0BAA0B,sBAAuB,aAAa,YACP,CAAC;AAErE,eAAO,MAAM,cAAc,WAAY,MAAM,SAAS,MAAM,aAAa,MAAM,SAe9E,CAAC;AAoBF,eAAO,MAAM,QAAQ,aAAoB,MAAM,aAAa,CAAC,QAAQ,EAAE,OAAO,KAAK,IAAI,kBAWtF,CAAC;AAEF,eAAO,MAAM,0BAA0B,oBAAqB,MAAM,EAAE,YAGnE,CAAC;AAEF,eAAO,MAAM,YAAY,oBAAqB,MAAM,EAAE,YAGrD,CAAC;AAEF,eAAO,MAAM,aAAa,aAAc;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,WAIjE,CAAC;AAEF,eAAO,MAAM,UAAU,GAAI,CAAC,SAAS,MAAM,cAAc,CAAC,KAAK,EAAE,MAAM,KAAK,CAAC,KAAG,CAAC,EAEhF,CAAC;AAEF,eAAO,MAAM,mBAAmB,aAAc,MAAM,UAAU;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAA;CAAE,KAAG,MAElG,CAAC;AAEF,eAAO,MAAM,4BAA4B,sBACpB,kBAAkB,qBAClB,aAAa,YAMjC,CAAC;AAEF,eAAO,MAAM,WAAW,8BAGrB;IACD,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAC9B,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,KAAG,iBAgBH,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,eAAe,SACnB,UAAU,cAAc,MAAM,eAC3B,CAAC,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC,EAAE,SAIrC,CAAC;AAEJ,eAAO,MAAM,SAAS;mBANV,CAAC,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC,EAAE;oBAA5B,CAAC,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC,EAAE;qBAA5B,CAAC,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC,EAAE;oBAA5B,CAAC,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC,EAAE;CAWvC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,kBAAmB,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC;;;;;;;;CAuCpF,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/v2/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAU5D,OAAO,KAAK,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACxE,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE/E,KAAK,UAAU,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;AAEpD,wBAAgB,UAAU,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,MAAM,GAAG;IAAE,CAAC,CAAC,EAAE,MAAM,GAAG,CAAC,CAAA;CAAE,CAStF;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,MAAM,YAEhE;AAED,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC,CAQjH;AACD;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,sBAAuB,aAAa,2BAAoB,MAAM,YAM5F,CAAC;AAEF,eAAO,MAAM,aAAa,sBAAuB,aAAa,YAK7D,CAAC;AAEF,eAAO,MAAM,YAAY,sBAAuB,aAAa,YACG,CAAC;AAEjE,eAAO,MAAM,0BAA0B,sBAAuB,aAAa,YACP,CAAC;AAErE,eAAO,MAAM,cAAc,WAAY,MAAM,SAAS,MAAM,aAAa,MAAM,SAe9E,CAAC;AAoBF,eAAO,MAAM,QAAQ,aAAoB,MAAM,aAAa,CAAC,QAAQ,EAAE,OAAO,KAAK,IAAI,kBAWtF,CAAC;AAEF,eAAO,MAAM,0BAA0B,oBAAqB,MAAM,EAAE,YAGnE,CAAC;AAEF,eAAO,MAAM,YAAY,oBAAqB,MAAM,EAAE,YAGrD,CAAC;AAEF,eAAO,MAAM,aAAa,aAAc;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,WAIjE,CAAC;AAEF,eAAO,MAAM,UAAU,GAAI,CAAC,SAAS,MAAM,cAAc,CAAC,KAAK,EAAE,MAAM,KAAK,CAAC,KAAG,CAAC,EAEhF,CAAC;AAEF,eAAO,MAAM,mBAAmB,aAAc,MAAM,UAAU;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAA;CAAE,KAAG,MAElG,CAAC;AAEF,eAAO,MAAM,4BAA4B,sBACpB,kBAAkB,qBAClB,aAAa,YAMjC,CAAC;AAEF,eAAO,MAAM,WAAW,8BAGrB;IACD,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAC9B,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,KAAG,iBAgBH,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,eAAe,SACnB,UAAU,cAAc,MAAM,eAC3B,CAAC,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC,EAAE,SAIrC,CAAC;AAEJ,eAAO,MAAM,SAAS;mBANV,CAAC,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC,EAAE;oBAA5B,CAAC,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC,EAAE;qBAA5B,CAAC,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC,EAAE;oBAA5B,CAAC,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC,EAAE;CAWvC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,kBAAmB,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC;;;;;;;;;CA6CpF,CAAC"}