Add initial code for crisp integration

Author: addisonschultz

integrations/crisp/.eslintrc.json

@@ -0,0 +1,3 @@
+{
+    "extends": ["@gitbook/eslint-config/integration"]
+}

integrations/crisp/assets/icon.png

@@ -0,0 +1,49 @@
+name: crisp
+title: Crisp
+icon: ./assets/icon.png
+description: Add the Crisp chat widget to your published GitBook content.
+externalLinks:
+    - label: Website
+      url: https://crisp.chat/en/
+visibility: public
+script: ./src/index.ts
+# The following scope(s) are available only to GitBook Staff
+# See https://developer.gitbook.com/integrations/configurations#scopes
+scopes:
+    - space:script:inject
+    - site:script:inject
+organization: gitbook
+contentSecurityPolicy:
+    script-src: client.crisp.chat;
+summary: |
+    # Overview
+
+    The Crisp integration for GitBook allows you to display the Crisp chat widget on your public documentation to connect and interact with your readers.
+
+    # How it works
+
+    Automatic chat widget on your documentation: Each of your connected GitBook spaces will fetch the Crisp chat widget script and inject it in your published content.
+
+    # Configure
+
+    You can configure the integration on single or multiple public spaces by navigating to the integrations in sub-navigation or org settings. You will then have to provide Crisp website ID to finish the configuration. This can be found in the URL from your Crisp dashboard.
+
+categories:
+    - analytics
+configurations:
+    space:
+        properties:
+            tracking_id:
+                type: string
+                title: Crisp Site ID
+                description: Available in the URL from your Crisp dashboard
+        required:
+            - tracking_id
+    site:
+        properties:
+            tracking_id:
+                type: string
+                title: Crisp Site ID
+                description: Available in the URL from your Crisp dashboard
+        required:
+            - tracking_id

integrations/crisp/gitbook-manifest.yaml

@@ -0,0 +1,18 @@
+{
+    "name": "@gitbook/integration-crisp",
+    "version": "0.0.1",
+    "private": true,
+    "dependencies": {
+        "@gitbook/api": "*",
+        "@gitbook/runtime": "*"
+    },
+    "devDependencies": {
+        "@gitbook/cli": "*"
+    },
+    "scripts": {
+        "lint": "eslint ./src/**/*.ts",
+        "typecheck": "tsc --noEmit",
+        "publish-integrations-staging": "gitbook publish .",
+        "publish-integrations": "gitbook publish ."
+    }
+}

integrations/crisp/package.json

@@ -0,0 +1,44 @@
+import {
+    createIntegration,
+    FetchPublishScriptEventCallback,
+    RuntimeContext,
+    RuntimeEnvironment,
+} from '@gitbook/runtime';
+
+import script from './script.raw.js';
+
+type CrispRuntimeContext = RuntimeContext<
+    RuntimeEnvironment<
+        {},
+        {
+            tracking_id?: string;
+        }
+    >
+>;
+
+export const handleFetchEvent: FetchPublishScriptEventCallback = async (
+    event,
+    { environment }: CrispRuntimeContext
+) => {
+    const trackingId =
+        environment.siteInstallation?.configuration?.tracking_id ??
+        environment.spaceInstallation.configuration.tracking_id;
+    if (!trackingId) {
+        throw new Error(
+            `The Crisp Website ID is missing from the configuration (ID: ${
+                'spaceId' in event ? event.spaceId : event.siteId
+            }).`
+        );
+    }
+
+    return new Response(script.replace('<TO_REPLACE>', trackingId), {
+        headers: {
+            'Content-Type': 'application/javascript',
+            'Cache-Control': 'max-age=604800',
+        },
+    });
+};
+
+export default createIntegration<CrispRuntimeContext>({
+    fetch_published_script: handleFetchEvent,
+});

integrations/crisp/src/index.ts

@@ -0,0 +1,17 @@
+// (function (h, o, t, j, a, r) {
+//     const trackingID = '<TO_REPLACE>';
+//     h.hj =
+//         h.hj ||
+//         function () {
+//             (h.hj.q = h.hj.q || []).push(arguments);
+//         };
+//     h._hjSettings = { hjid: trackingID, hjsv: 6 };
+//     a = o.getElementsByTagName('head')[0];
+//     r = o.createElement('script');
+//     r.async = 1;
+//     r.src = t + h._hjSettings.hjid + j + h._hjSettings.hjsv;
+//     a.appendChild(r);
+// })(window, document, 'https://static.hotjar.com/c/hotjar-', '.js?sv=');
+
+// Example script
+// <script type="text/javascript">window.$crisp=[];window.CRISP_WEBSITE_ID="<TO_REPLACE>";(function(){d=document;s=d.createElement("script");s.src="https://client.crisp.chat/l.js";s.async=1;d.getElementsByTagName("head")[0].appendChild(s);})();</script>

integrations/crisp/src/script.raw.js

@@ -0,0 +1,3 @@
+{
+    "extends": "@gitbook/tsconfig/integration.json"
+}