crisp-api 9.12.1 → 10.0.2

package/CHANGELOG.md

@@ -1,6 +1,20 @@
 Changelog
 =========
 
+## v10.0.1
+
+* Routes supporting pagination can be used without page argument (page 1 by default)
+
+## v10.0.0
+
+* Typescript support (retrocompatible)
+
+## v9.13.0
+
+### New Features
+
+* Added support for the `identity:verify:request` RTM API event.
+
 ## v9.12.1
 
 ### New Features

package/README.md

@@ -3496,7 +3496,7 @@ To start listening for events and bind a handler, check out the [events over Web
 
 You will need to adjust your code so that:
 
-1. The RTM events mode is set to Web Hooks: `CrispClient.setRtmMode(Crisp.RTM_MODES.WebHooks)`
+1. The RTM events mode is set to Web Hooks: `CrispClient.setRtmMode("webhooks")`
 2. Your HTTP endpoint mounts a route listening for POST requests, and upon receiving requests:
     1. It verifies the requests with: `CrispClient.verifyHook(secret, body, timestamp, signature)`
     2. It receives the Web Hook with: `CrispClient.receiveHook(body)`
@@ -3509,7 +3509,7 @@ To start listening for events and bind a handler, check out the [events over Web
 
 You will need to adjust your code so that:
 
-1. The RTM events mode is set to WebSockets: `CrispClient.setRtmMode(Crisp.RTM_MODES.WebSockets)`
+1. The RTM events mode is set to WebSockets: `CrispClient.setRtmMode("websockets")`
 
 ### Available realtime events
 
@@ -3651,6 +3651,10 @@ Available events are listed below:
   * **Call Request Rejected** [`user`, `plugin`]:
     * `call:request:rejected`
 
+* #### **Identity Events**: [Reference](https://docs.crisp.chat/references/rtm-api/v1/#identity-events)
+  * **Identity Verify Request** [`plugin`]:
+    * `identity:verify:request`
+
 * #### **Widget Events**: [Reference](https://docs.crisp.chat/references/rtm-api/v1/#widget-events)
   * **Widget Action Processed** [`user`]:
     * `widget:action:processed`

package/dist/crisp.d.ts

@@ -0,0 +1,167 @@
+import { Socket } from "socket.io-client";
+import { Emitter } from "mitt";
+import Bucket from "./services/bucket";
+import Media from "./services/media";
+import Plugin from "./services/plugin";
+import { WebsiteServiceInterface } from "./services/website";
+export * from "./resources";
+export type RTM_MODES = "websockets" | "webhooks";
+interface CrispAuth {
+    tier: CrispTier;
+    identifier: string | null;
+    key: string | null;
+    token: string | null;
+}
+export type CrispTier = "user" | "plugin";
+/**
+ * Crisp API Library
+ */
+export declare class Crisp {
+    bucket: Bucket;
+    media: Media;
+    plugin: Plugin;
+    website: WebsiteServiceInterface;
+    /**
+     * @deprecated Use import { RTM_MODES } instead
+     */
+    static RTM_MODES: {
+        WebSockets: RTM_MODES;
+        WebHooks: RTM_MODES;
+    };
+    auth: CrispAuth;
+    _rest: {
+        host: string;
+        basePath: string;
+    };
+    _rtm: {
+        host: string;
+        mode: RTM_MODES;
+    };
+    _useragent: string;
+    _emitter: Emitter<Record<import("mitt").EventType, unknown>>;
+    _socket: Socket | null;
+    _loopback: Emitter<Record<string, unknown>> | null;
+    _lastEventRebind: any;
+    _brokerScheduler: typeof setTimeout | null;
+    _brokerBindHooks: ((modeInstance: any, emitter: any) => void)[];
+    _boundEvents: {};
+    /**
+     * Constructor
+     */
+    constructor();
+    /**
+     * Sets the REST API host
+     */
+    setRestHost(host: string): void;
+    /**
+     * Sets the RTM API host
+     */
+    setRtmHost(host: string): void;
+    /**
+     * Sets the RTM channel mode (ie. WebSockets or Web Hooks)
+     */
+    setRtmMode(mode: "websockets" | "webhooks"): void;
+    /**
+     * Sets the authentication tier
+     */
+    setTier(tier: "user" | "plugin"): void;
+    /**
+     * Authenticates
+     */
+    authenticate(identifier: string, key: string): void;
+    /**
+     * Authenticates (with tier)
+     */
+    authenticateTier(tier: CrispTier, identifier: string, key: string): void;
+    /**
+     * Method wrapper to HEAD a resource
+     */
+    head(resource: string, query?: object | null): Promise<any>;
+    /**
+     * Method wrapper to GET a resource
+     */
+    get(resource: string, query?: object): Promise<any>;
+    /**
+     * Method wrapper to POST a resource
+     */
+    post(resource: string, query: object | null, body: object | null): Promise<any>;
+    /**
+     * Method wrapper to PATCH a resource
+     */
+    patch(resource: string, query: object | null, body: object | null): Promise<any>;
+    /**
+     * Method wrapper to PUT a resource
+     */
+    put(resource: string, query: object | null, body: object | null): Promise<any>;
+    /**
+     * Method wrapper to DELETE a resource
+     */
+    delete(resource: string, query?: object | null, body?: object | null): Promise<any>;
+    /**
+     * Binds RTM event
+     */
+    on(event: string, callback: (data: any) => void): Promise<unknown>;
+    /**
+     * Receives a raw event and dispatches it to the listener (used for Web Hooks)
+     */
+    receiveHook(body: Record<string, unknown>): Error;
+    /**
+     * Verifies an event string and checks that signatures match (used for Web \
+     *   Hooks)
+     */
+    verifyHook(secret: string, body: object, timestamp: number, signature: string): boolean;
+    /**
+     * Verifies an event string and checks that signatures match (used for \
+     *   Widgets)
+     */
+    verifyWidget(secret: string, body: object, timestamp: number, signature: string): boolean;
+    /**
+     * Rebinds socket events (used for WebSockets)
+     */
+    rebindSocket(): Promise<void>;
+    /**
+     * Prepares a URI based from path segments
+     */
+    prepareRestUrl(paths: string[]): string;
+    /**
+     * Binds services to the main object
+     */
+    _prepareServices(): void;
+    /**
+     * Binds resources to the service object
+     */
+    private prepareResources;
+    /**
+     * Binds broker to the main object
+     */
+    private prepareBroker;
+    /**
+     * Connects loopback (used for Web Hooks)
+     */
+    private connectLoopback;
+    /**
+     * Connects socket, using preferred RTM API host (used for WebSockets)
+     */
+    private connectSocket;
+    /**
+     * Authenticates client (used for WebSockets)
+     */
+    private emitAuthenticateSocket;
+    /**
+     * Unstacks pending broker bind hooks
+     */
+    private unstackBrokerBindHooks;
+    /**
+     * Performs a request to REST API
+     */
+    private request;
+    /**
+     * Reads reason for error response
+     */
+    private readErrorResponseReason;
+    /**
+     * Verifies an event string and checks that signatures match
+     */
+    private verifySignature;
+}
+export default Crisp;