added stepsailor integration

integrations/stepsailor/gitbook-manifest.yaml

@@ -0,0 +1,56 @@
+name: stepsailor
+title: Stepsailor Assistant
+script: src/index.ts
+icon: ./assets/logo.png
+description: 'Add the Stepsailor assistant to your documentation'
+externalLinks:
+    - label: Website
+      url: https://www.stepsailor.com/
+visibility: public
+target: site
+scopes:
+    - site:script:inject
+contentSecurityPolicy:
+    font-src: |
+        static.api.stepsailor.com
+    script-src: |
+        static.api.stepsailor.com;
+        https://static.api.stepsailor.com/orion-ai/index.js;
+    style-src: |
+        static.api.stepsailor.com
+        https://static.api.stepsailor.com/orion-ai/main.css;
+summary: |
+    # Overview
+
+    The Stepsailor integration for GitBook brings Orion, an AI-powered assistant, to your documentation that enables your users to ask questions and get answers directly within your documentation.
+
+    # How it works
+
+    Orion provides an in-app AI assistant that answers product questions, displays educational videos within your published content.
+
+    # Configure
+
+    You can configure the integration on your GitBook spaces by providing your organization ID, deployConfig ID and API Key. These credentials connect your documentation to Stepsailor's knowledge base and enable the AI-powered features in your published content.
+configurations:
+    site:
+        properties:
+            organizationId:
+                type: string
+                title: Organization ID
+                description: You can copy that in the deploy config page
+            deployConfigId:
+                type: string
+                title: Deploy Config ID
+                description: You can copy that in the deploy config page
+            apiKey:
+                type: string
+                title: API Key
+                description: You can copy that in the deploy config page
+        required:
+            - organizationId
+            - deployConfigId
+            - apiKey
+categories:
+    - content
+organization: GXGct7gbl46efsxXM5JQ
+secrets: {}

integrations/stepsailor/package.json

@@ -0,0 +1,16 @@
+{
+  "name": "gitbook-orion",
+  "private": true,
+  "version": "0.1.0",
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "publish": "gitbook publish ."
+  },
+  "dependencies": {
+    "@gitbook/runtime": "*"
+  },
+  "devDependencies": {
+    "@gitbook/cli": "^0.20.1",
+    "@gitbook/tsconfig": "*"
+  }
+}

integrations/stepsailor/src/index.ts

@@ -0,0 +1,52 @@
+import {
+    createIntegration,
+    FetchPublishScriptEventCallback,
+    RuntimeContext,
+    RuntimeEnvironment,
+} from '@gitbook/runtime';
+
+import script from './script.raw.js';
+
+type StepsailorRuntimeContext = RuntimeContext<
+    RuntimeEnvironment<
+        {},
+        {
+            organizationId?: string;
+            deployConfigId?: string;
+            apiKey?: string;
+        }
+    >
+>;
+
+export const handleFetchEvent: FetchPublishScriptEventCallback = async (
+    event,
+    { environment }: StepsailorRuntimeContext,
+) => {
+    const organizationId = environment.siteInstallation?.configuration?.organizationId;
+    const deployConfigId = environment.siteInstallation?.configuration?.deployConfigId;
+    const apiKey = environment.siteInstallation?.configuration?.apiKey;
+
+    if (!organizationId || !deployConfigId || !apiKey) {
+        throw new Error(
+            `The Stepsailor organization ID, deploy config ID and API key are missing from the configuration (ID: ${
+                'spaceId' in event ? event.spaceId : event.siteId
+            }).`,
+        );
+    }
+
+    const scriptContent = (script as string)
+        .replace('<TO_REPLACE_ORGANIZATION_ID>', organizationId)
+        .replace('<TO_REPLACE_DEPLOY_CONFIG_ID>', deployConfigId)
+        .replace('<TO_REPLACE_API_KEY>', apiKey);
+
+    return new Response(scriptContent, {
+        headers: {
+            'Content-Type': 'application/javascript',
+            'Cache-Control': 'max-age=604800',
+        },
+    });
+};
+
+export default createIntegration<StepsailorRuntimeContext>({
+    fetch_published_script: handleFetchEvent,
+});

integrations/stepsailor/src/script.raw.js

@@ -0,0 +1,10 @@
+(function (d, s) {
+    d = document;
+    s = d.createElement('script');
+    s.src = 'https://static.api.stepsailor.com/orion-ai/index.js';
+    s.setAttribute('data-company-id', '<TO_REPLACE_ORGANIZATION_ID>');
+    s.setAttribute('data-deploy-config-id', '<TO_REPLACE_DEPLOY_CONFIG_ID>');
+    s.setAttribute('data-secret', '<TO_REPLACE_API_KEY>');
+    s.async = 1;
+    d.getElementsByTagName('body')[0].appendChild(s);
+})(window, document);

integrations/stepsailor/tsconfig.json

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