crisp-api 9.13.0 → 10.0.2

package/lib/resources/WebsiteSettings.ts

@@ -0,0 +1,192 @@
+/*
+ * node-crisp-api
+ *
+ * Copyright 2022, Crisp IM SAS
+ * Author: Baptiste Jamin <baptiste@crisp.chat>
+ */
+
+/**************************************************************************
+ * IMPORTS
+ ***************************************************************************/
+
+// PROJECT: RESOURCES
+import BaseResource from "./BaseResource";
+
+export interface WebsiteSettings {
+  websiteID?: string;
+  name?: string;
+  domain?: string;
+  logo?: string;
+  audit?: WebsiteSettingsAudit;
+  contact?: WebsiteSettingsContact;
+  inbox?: WebsiteSettingsInbox;
+  emails?: WebsiteSettingsEmails;
+  chatbox?: WebsiteSettingsChatbox;
+}
+
+export interface WebsiteSettingsAudit {
+  log?: boolean;
+}
+
+export interface WebsiteSettingsContact {
+  email?: string;
+  phone?: string;
+  messenger?: string;
+  telegram?: string;
+  twitter?: string;
+  whatsapp?: string;
+  instagram?: string;
+}
+
+export interface WebsiteSettingsInbox {
+  lock_removal?: boolean;
+  force_operator_token?: boolean;
+  locale?: string;
+}
+
+export interface WebsiteSettingsEmails {
+  rating?: boolean;
+  transcript?: boolean;
+  enrich?: boolean;
+  junk_filter?: boolean;
+}
+
+export interface WebsiteSettingsChatbox {
+  tile?: string;
+  wait_game?: boolean;
+  website_logo?: boolean;
+  last_operator_face?: boolean;
+  ongoing_operator_face?: boolean;
+  activity_metrics?: boolean;
+  operator_privacy?: boolean;
+  visitor_privacy?: boolean;
+  availability_tooltip?: boolean;
+  hide_vacation?: boolean;
+  hide_on_away?: boolean;
+  hide_on_mobile?: boolean;
+  position_reverse?: boolean;
+  email_visitors?: boolean;
+  phone_visitors?: boolean;
+  force_identify?: boolean;
+  ignore_privacy?: boolean;
+  visitor_compose?: boolean;
+  file_transfer?: boolean;
+  audio_record?: boolean;
+  overlay_search?: boolean;
+  overlay_mode?: boolean;
+  helpdesk_link?: boolean;
+  helpdesk_only?: boolean;
+  status_health_dead?: boolean;
+  check_domain?: boolean;
+  color_theme?: string;
+  text_theme?: string;
+  welcome_message?: string;
+  locale?: string;
+  allowed_pages?: string[];
+  blocked_pages?: string[];
+  blocked_countries?: string[];
+  blocked_locales?: string[];
+}
+
+export interface WebsiteSettingsUpdate {
+  websiteID?: string;
+  name?: string;
+  domain?: string;
+  logo?: string;
+  audit?: WebsiteSettingsUpdateAudit;
+  contact?: WebsiteSettingsUpdateContact;
+  inbox?: WebsiteSettingsUpdateInbox;
+  emails?: WebsiteSettingsUpdateEmails;
+  chatbox?: WebsiteSettingsUpdateChatbox;
+}
+
+export interface WebsiteSettingsUpdateAudit {
+  log?: boolean;
+}
+
+export interface WebsiteSettingsUpdateContact {
+  email?: string;
+  phone?: string;
+  messenger?: string;
+  telegram?: string;
+  twitter?: string;
+  whatsapp?: string;
+  instagram?: string;
+}
+
+export interface WebsiteSettingsUpdateInbox {
+  lock_removal?: boolean;
+  force_operator_token?: boolean;
+  locale?: string;
+}
+
+export interface WebsiteSettingsUpdateEmails {
+  rating?: boolean;
+  transcript?: boolean;
+  enrich?: boolean;
+  junk_filter?: boolean;
+}
+
+export interface WebsiteSettingsUpdateChatbox {
+  tile?: string;
+  wait_game?: boolean;
+  website_logo?: boolean;
+  last_operator_face?: boolean;
+  ongoing_operator_face?: boolean;
+  activity_metrics?: boolean;
+  operator_privacy?: boolean;
+  visitor_privacy?: boolean;
+  availability_tooltip?: boolean;
+  hide_vacation?: boolean;
+  hide_on_away?: boolean;
+  hide_on_mobile?: boolean;
+  position_reverse?: boolean;
+  email_visitors?: boolean;
+  phone_visitors?: boolean;
+  force_identify?: boolean;
+  ignore_privacy?: boolean;
+  visitor_compose?: boolean;
+  file_transfer?: boolean;
+  audio_record?: boolean;
+  overlay_search?: boolean;
+  overlay_mode?: boolean;
+  helpdesk_link?: boolean;
+  helpdesk_only?: boolean;
+  status_health_dead?: boolean;
+  check_domain?: boolean;
+  color_theme?: string;
+  text_theme?: string;
+  welcome_message?: string;
+  locale?: string;
+  allowed_pages?: string[];
+  blocked_pages?: string[];
+  blocked_countries?: string[];
+  blocked_locales?: string[];
+  blocked_ips?: string[];
+}
+
+/**
+ * Crisp WebsiteSettings Resource
+ */
+class WebsiteSettingsService extends BaseResource {
+  /**
+   * Get Website Settings
+   */
+  getWebsiteSettings(websiteID: string) : Promise<WebsiteSettings> {
+    return this.crisp.get(
+      this.crisp.prepareRestUrl(["website", websiteID, "settings"])
+    );
+  };
+
+  /**
+   * Update Website Settings
+   */
+  updateWebsiteSettings(websiteID: string, settings: WebsiteSettingsUpdate) {
+    return this.crisp.patch(
+      this.crisp.prepareRestUrl(["website", websiteID, "settings"]), null, settings
+    );
+  };
+}
+
+export default WebsiteSettingsService;
+

package/lib/resources/WebsiteVerify.ts

@@ -0,0 +1,76 @@
+/*
+ * node-crisp-api
+ *
+ * Copyright 2022, Crisp IM SAS
+ * Author: Valerian Saliou <valerian@valeriansaliou.name>
+ */
+
+/**************************************************************************
+ * IMPORTS
+ ***************************************************************************/
+
+// PROJECT: RESOURCES
+import BaseResource from "./BaseResource";
+
+export interface WebsiteVerifyKeyData {
+  data?: WebsiteVerifyKey;
+}
+
+export interface WebsiteVerifySettings {
+  enabled?: boolean;
+}
+
+export interface WebsiteVerifyKey {
+  secret?: string;
+}
+
+export interface WebsiteVerifySettingsUpdate {
+  enabled?: boolean;
+}
+
+/**
+ * Crisp WebsiteVerify Resource
+ */
+class WebsiteVerify extends BaseResource {
+  /**
+   * Get Verify Settings
+   */
+  getVerifySettings(websiteID: string) : Promise<WebsiteVerifySettings> {
+    return this.crisp.get(
+      this.crisp.prepareRestUrl(["website", websiteID, "verify", "settings"])
+    );
+  };
+
+  /**
+   * Update Verify Settings
+   */
+  updateVerifySettings(websiteID: string, settings: WebsiteVerifySettingsUpdate) {
+    return this.crisp.patch(
+      this.crisp.prepareRestUrl(["website", websiteID, "verify", "settings"]),
+
+      null, settings
+    );
+  };
+
+  /**
+   * Get Verify Key
+   */
+  getVerifyKey(websiteID: string) : Promise<WebsiteVerifyKey> {
+    return this.crisp.get(
+      this.crisp.prepareRestUrl(["website", websiteID, "verify", "key"])
+    );
+  };
+
+  /**
+   * Roll Verify Key
+   */
+  rollVerifyKey(websiteID: string) {
+    return this.crisp.post(
+      this.crisp.prepareRestUrl(["website", websiteID, "verify", "key"]),
+
+      null, null
+    );
+  };
+}
+
+export default WebsiteVerify;

package/lib/resources/WebsiteVisitors.ts

@@ -0,0 +1,196 @@
+/*
+ * node-crisp-api
+ *
+ * Copyright 2022, Crisp IM SAS
+ * Author: Valerian Saliou <valerian@valeriansaliou.name>
+ */
+
+/**************************************************************************
+ * IMPORTS
+ ***************************************************************************/
+
+// PROJECT: RESOURCES
+import BaseResource from "./BaseResource";
+
+export interface WebsiteVisitorCount {
+  count?: number;
+  active?: number;
+  limited?: boolean;
+}
+
+export interface WebsiteVisitor {
+  session_id?: string;
+  inbox_id?: string;
+  nickname?: string;
+  email?: string;
+  avatar?: string;
+  useragent?: string;
+  initiated?: boolean;
+  active?: boolean;
+  last_page?: WebsiteVisitorLastPage;
+  geolocation?: WebsiteVisitorGeolocation;
+  timezone?: number;
+  capabilities?: string[];
+  locales?: string[];
+}
+
+export interface WebsiteVisitorLastPage {
+  page_title?: string;
+  page_url?: string;
+}
+
+export interface WebsiteVisitorGeolocation {
+  coordinates?: WebsiteVisitorGeolocationCoordinates;
+  city?: string;
+  region?: string;
+  country?: string;
+}
+
+export interface WebsiteVisitorGeolocationCoordinates {
+  latitude?: number;
+  longitude?: number;
+}
+
+export interface WebsiteVisitorsMapPointsData {
+  data?: WebsiteVisitorsMapPoint[];
+}
+
+export interface WebsiteVisitorsMapPoint {
+  visitors?: WebsiteVisitorsMapPointVisitors;
+  geolocation?: WebsiteVisitorsMapPointGeolocation;
+}
+
+export interface WebsiteVisitorsMapPointGeolocation {
+  coordinates?: WebsiteVisitorsMapPointGeolocationCoordinates;
+  city?: string;
+  region?: string;
+  country?: string;
+}
+
+export interface WebsiteVisitorsMapPointGeolocationCoordinates {
+  latitude?: number;
+  longitude?: number;
+}
+
+export interface WebsiteVisitorsMapPointVisitors {
+  count?: number;
+  threshold?: number;
+  sessions?: WebsiteVisitorsMapPointVisitorsSession[];
+}
+
+export interface WebsiteVisitorsMapPointVisitorsSession {
+  session_id?: string;
+  nickname?: string;
+  email?: string;
+  avatar?: string;
+  initiated?: boolean;
+  active?: boolean;
+  last_page?: WebsiteVisitorLastPage;
+  timezone?: number;
+  capabilities?: string[];
+  locales?: string[];
+}
+
+export interface WebsiteVisitorsToken {
+  session_id?: string;
+}
+
+export interface WebsiteVisitorsBlocked {
+  rule?: string[];
+  blocked?: number;
+}
+
+/**
+ * Crisp WebsiteVisitors Resource
+ */
+class WebsiteVisitors extends BaseResource {
+  /**
+   * Count Visitors
+   */
+  countVisitors(websiteID: string) : Promise<WebsiteVisitorCount> {
+    return this.crisp.get(
+      this.crisp.prepareRestUrl(["website", websiteID, "visitors", "count"])
+    );
+  };
+
+  /**
+   * List Visitors
+   */
+  listVisitors(websiteID: string, pageNumber: number = 1) : Promise<WebsiteVisitor[]> {
+    return this.crisp.get(
+      this.crisp.prepareRestUrl([
+        "website", websiteID, "visitors", "list", String(pageNumber)
+      ])
+    );
+  };
+
+  /**
+   * Pinpoint Visitors On A Map
+   */
+  pinpointVisitorsOnMap(
+    websiteID: string, centerLongitude: number, centerLatitude: number, centerRadius: number
+  ) : Promise<WebsiteVisitorsMapPoint[]> {
+    // Generate query
+    const query: Record<string, string> = {};
+
+    if (typeof centerLongitude === "number") {
+      query.center_longitude = String(centerLongitude);
+    }
+
+    if (typeof centerLatitude === "number") {
+      query.center_latitude = String(centerLatitude);
+    }
+
+    if (typeof centerRadius === "number") {
+      query.center_radius = String(centerRadius);
+    }
+
+    return this.crisp.get(
+      this.crisp.prepareRestUrl([
+        "website", websiteID, "visitors", "map"
+      ]),
+
+      query
+    );
+  };
+
+  /**
+   * Get Session Identifier From Token
+   */
+  getSessionIdentifierFromToken(websiteID: string, tokenID: string) : Promise<WebsiteVisitorsToken> {
+    return this.crisp.get(
+      this.crisp.prepareRestUrl([
+        "website", websiteID, "visitors", "token", tokenID
+      ])
+    );
+  };
+
+  /**
+   * Count Blocked Visitors
+   */
+  countBlockedVisitors(websiteID: string) : Promise<WebsiteVisitorsBlocked> {
+    return this.crisp.get(
+      this.crisp.prepareRestUrl(["website", websiteID, "visitors", "blocked"])
+    );
+  };
+
+  /**
+   * Count Blocked Visitors In Rule
+   */
+  countBlockedVisitorsInRule(websiteID: string, rule: string) : Promise<number> {
+    return this.crisp.get(
+      this.crisp.prepareRestUrl(["website", websiteID, "visitors", "blocked", rule])
+    );
+  };
+
+  /**
+   * Clear Blocked Visitors In Rule
+   */
+  clearBlockedVisitorsInRule(websiteID: string, rule: string) {
+    return this.crisp.delete(
+      this.crisp.prepareRestUrl(["website", websiteID, "visitors", "blocked", rule])
+    );
+  };
+}
+
+export default WebsiteVisitors;

package/lib/resources/index.ts

@@ -0,0 +1,25 @@
+/*
+ * node-crisp-api
+ *
+ * Copyright 2022, Crisp IM SAS
+ * Author: Baptiste Jamin <baptiste@crisp.chat>
+ */
+
+// Used to export all types
+export * from "./BaseResource";
+export * from "./BucketURL";
+export * from "./MediaAnimation";
+export * from "./PluginConnect";
+export * from "./PluginSubscription";
+export * from "./WebsiteAnalytics";
+export * from "./WebsiteAvailability";
+export * from "./WebsiteBase";
+export * from "./WebsiteBatch";
+export * from "./WebsiteCampaign";
+export * from "./WebsiteConversation";
+export * from "./WebsiteHelpdesk";
+export * from "./WebsiteOperator";
+export * from "./WebsitePeople";
+export * from "./WebsiteSettings";
+export * from "./WebsiteVerify";
+export * from "./WebsiteVisitors";

package/lib/services/bucket.ts

@@ -0,0 +1,28 @@
+/*
+ * node-crisp-api
+ *
+ * Copyright 2022, Crisp IM SAS
+ * Author: Baptiste Jamin <baptiste@crisp.chat>
+ */
+
+/**************************************************************************
+ * IMPORTS
+ ***************************************************************************/
+
+// PROJECT: RESOURCES
+import BucketURL from "@/resources/BucketURL";
+
+/**
+ * Bucket Service
+ */
+class BucketService {
+  /* eslint-disable @typescript-eslint/no-explicit-any */
+  public __resources: any[] = [
+    BucketURL
+  ];
+}
+
+export interface BucketServiceInterface extends
+  BucketURL {}
+
+export default BucketService;

package/lib/services/media.ts

@@ -0,0 +1,28 @@
+/*
+ * node-crisp-api
+ *
+ * Copyright 2022, Crisp IM SAS
+ * Author: Baptiste Jamin <baptiste@crisp.chat>
+ */
+
+/**************************************************************************
+ * IMPORTS
+ ***************************************************************************/
+
+// PROJECT: RESOURCES
+import MediaAnimation from "@/resources/MediaAnimation";
+
+/**
+ * Crisp Media Service
+ */
+class MediaService {
+  /* eslint-disable @typescript-eslint/no-explicit-any */
+  public __resources: any[] = [
+    MediaAnimation
+  ];
+}
+
+export interface MediaServiceInterface extends
+  MediaAnimation {}
+
+export default MediaService;

package/lib/services/plugin.ts

@@ -0,0 +1,32 @@
+/*
+ * node-crisp-api
+ *
+ * Copyright 2022, Crisp IM SAS
+ * Author: Baptiste Jamin <baptiste@crisp.chat>
+ */
+
+/**************************************************************************
+ * IMPORTS
+ ***************************************************************************/
+
+// PROJECT: RESOURCES
+import PluginConnect from "@/resources/PluginConnect";
+import PluginSubscription from "@/resources/PluginSubscription";
+
+/**
+ * Crisp Plugin Service
+ */
+class PluginService {
+  /* eslint-disable @typescript-eslint/no-explicit-any */
+  public __resources: any[] = [
+    PluginConnect,
+    PluginSubscription
+  ];
+}
+
+export interface PluginServiceInterface extends
+  PluginConnect,
+  PluginSubscription {
+}
+
+export default PluginService;

package/lib/services/website.ts

@@ -0,0 +1,62 @@
+/*
+ * node-crisp-api
+ *
+ * Copyright 2022, Crisp IM SAS
+ * Author: Baptiste Jamin <baptiste@crisp.chat>
+ */
+
+/**************************************************************************
+ * IMPORTS
+ ***************************************************************************/
+
+// PROJECT: RESOURCES
+import WebsiteBase from "@/resources/WebsiteBase";
+import WebsiteAnalytics from "@/resources/WebsiteAnalytics";
+import WebsiteAvailability from "@/resources/WebsiteAvailability";
+import WebsiteBatch from "@/resources/WebsiteBatch";
+import WebsiteCampaign from "@/resources/WebsiteCampaign";
+import WebsiteConversation from "@/resources/WebsiteConversation";
+import WebsiteOperator from "@/resources/WebsiteOperator";
+import WebsitePeople from "@/resources/WebsitePeople";
+import WebsiteHelpdesk from "@/resources/WebsiteHelpdesk";
+import WebsiteSettings from "@/resources/WebsiteSettings";
+import WebsiteVerify from "@/resources/WebsiteVerify";
+import WebsiteVisitors from "@/resources/WebsiteVisitors";
+
+/**
+ * Website Service
+ */
+class WebsiteService {
+  /* eslint-disable @typescript-eslint/no-explicit-any */
+  public __resources: any[] = [
+    WebsiteBase,
+    WebsiteAnalytics,
+    WebsiteAvailability,
+    WebsiteBatch,
+    WebsiteCampaign,
+    WebsiteConversation,
+    WebsiteOperator,
+    WebsitePeople,
+    WebsiteHelpdesk,
+    WebsiteSettings,
+    WebsiteVerify,
+    WebsiteVisitors
+  ];
+}
+
+export interface WebsiteServiceInterface extends
+  WebsiteBase,
+  WebsiteAnalytics,
+  WebsiteAvailability,
+  WebsiteBatch,
+  WebsiteCampaign,
+  WebsiteConversation,
+  WebsiteOperator,
+  WebsitePeople,
+  WebsiteHelpdesk,
+  WebsiteSettings,
+  WebsiteVerify,
+  WebsiteVisitors {
+}
+
+export default WebsiteService;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "crisp-api",
   "description": "Crisp API wrapper for Node - official, maintained by Crisp",
-  "version": "9.13.0",
+  "version": "10.0.2",
   "homepage": "https://github.com/crisp-im/node-crisp-api",
   "license": "MIT",
   "author": {
@@ -34,23 +34,28 @@
       "url": "https://github.com/crisp-im/node-crisp-api/blob/master/LICENSE"
     }
   ],
-  "main": "lib/crisp.js",
-  "types": "types/crisp.d.ts",
+  "main": "dist/crisp.js",
+  "types": "dist/crisp.d.ts",
   "engines": {
-    "node": ">= 10.19.0"
+    "node": ">= 16.0.0"
   },
   "scripts": {
-    "test": "check-build",
-    "generate:types": "rm -rf ./types/* && tsc"
+    "test": "eslint lib",
+    "build": "npx tsc && npx tsc-alias && node -e \"const fs=require('fs');const f='dist/crisp.js';const v=require('./package.json').version;fs.writeFileSync(f, fs.readFileSync(f,'utf8').replace(/__PKG_VERSION_PLACEHOLDER__/g,v));\""
   },
   "devDependencies": {
-    "check-build": "2.8.2",
-    "typescript": "5.1.6"
+    "@typescript-eslint/eslint-plugin": "8.39.1",
+    "tsc-alias": "1.8.16",
+    "typescript": "5.9.2",
+    "eslint": "9.29.0",
+    "eslint-plugin-crisp": "1.1.13",
+    "eslint-plugin-jsdoc": "^54.1.0",
+    "globals": "15.15.0"
   },
   "dependencies": {
-    "socket.io-client": "4.7.2",
-    "fbemitter": "github:crisp-dev/emitter#695f60594bdca0c876e5c232de57702ab3151b6f",
-    "got": "11.8.5"
+    "mitt": "3.0.1",
+    "got": "11.8.5",
+    "socket.io-client": "4.7.2"
   },
   "keywords": [
     "crisp",