@seeka-labs/cli-apps 3.7.0 → 3.8.2

package/dist/ai-context/internal/examples/v2/typeform/app/server/src/lib/typeform/webhooks.ts

@@ -0,0 +1,182 @@
+import { TypeformFormBinding } from '@seeka-app-typeform/lib';
+import { createHmac } from 'crypto';
+import { Logger } from "winston";
+import { createOrUpdateInstallation, SeekaAppInstallState } from "../state/seeka/installations";
+import { getTypeformAccessToken, TypeformAccessToken } from "./auth";
+
+const getWebhookUrl = (installation: SeekaAppInstallState): string => {
+    return `${process.env.SELF_HOST_BASEURL}/api/webhook/typeform?seekaAppId=${process.env.SEEKA_APP_ID}&seekaAppInstallId=${installation.applicationInstallId}`;
+}
+
+const getWebhookTag = (installation: SeekaAppInstallState): string => {
+    return `seeka-${process.env.SEEKA_APP_ID}-${installation.applicationInstallId}`;
+}
+
+export const maintainWebhooks = async (installation: SeekaAppInstallState, isUninstallingApp: boolean, logger: Logger): Promise<void> => {
+    const token = await getTypeformAccessToken(installation, logger);
+
+    if (!isUninstallingApp) {
+        const bindings: TypeformFormBinding[] = installation?.installationState?.formBindings || [];
+
+        const promises: Promise<TypeformWebhook>[] = [];
+
+        for (const binding of bindings) {
+            promises.push(
+                maintainWebhooksForForm(binding.typeFormFormId, token, installation, logger).catch(err => {
+                    return null;
+                }))
+        }
+
+        const activeWebhooks: TypeformWebhook[] = (await Promise.all(promises)).filter(Boolean);
+        const previousWebhooks = installation.installationState.boundWebhooks || [];
+
+        const webhooksToRemove = previousWebhooks.filter(w => !activeWebhooks.find(a => a.form_id == w.formId));
+        for (const webhook of webhooksToRemove) {
+            await deleteWebhook(webhook.formId, token, webhook.webhookTag, logger);
+        }
+
+        installation.installationState.boundWebhooks = activeWebhooks.map(w => ({ formId: w.form_id, webhookTag: w.tag }));
+    }
+
+    if (isUninstallingApp) {
+        // Handle cleanup of webhooks for forms that are no longer bound / removed in settings
+        // Check if there are any form IDs in the installation state that are not in the form bindings
+        for (const webhook of installation.installationState.boundWebhooks) {
+            await deleteWebhook(webhook.formId, token, webhook.webhookTag, logger);
+        }
+        installation.installationState.boundWebhooks = [];
+    }
+
+    await createOrUpdateInstallation(installation, logger);
+}
+
+const maintainWebhooksForForm = async (formId: string, token: TypeformAccessToken, installation: SeekaAppInstallState, logger: Logger): Promise<TypeformWebhook | null> => {
+    try {
+        const webhooks = await listWebhooks(formId, token, logger);
+        const webhookUrl = getWebhookUrl(installation);
+        const webhookTag = getWebhookTag(installation);
+
+        const existing = webhooks.find(w => w.url == webhookUrl);
+        if (existing) {
+            // Webhook already exists
+            logger.debug('Typeform webhook already exists', { webhookUrl });
+
+            return existing;
+        }
+        else {
+            return await createWebhook(formId, webhookTag, token, webhookUrl, logger);
+        }
+    }
+    catch (err) {
+        logger.error('Failed to maintain webhooks for form', { formId, err });
+        return null;
+    }
+}
+
+export const throwOnInvalidTypeformWebhook = (typeformSignature: string, body: string): void => {
+    // https://www.typeform.com/developers/webhooks/secure-your-webhooks/
+    const webhookSigningKey = process.env.TYPEFORM_WEBHOOK_SECRET as string;
+
+    const hash = createHmac('sha256', webhookSigningKey)
+        .update(body)
+        .digest('base64')
+
+    if (typeformSignature !== `sha256=${hash}`) {
+        // Signature is invalid!
+        throw new Error('Invalid Signature');
+    }
+}
+
+const deleteWebhook = async (formId: string, token: TypeformAccessToken, webhookTag: string, logger: Logger): Promise<void> => {
+    const url = `https://api.typeform.com/forms/${formId}/webhooks/${webhookTag}`;
+
+    const options = {
+        method: 'DELETE',
+        headers: { 'Content-Type': 'application/json', Authorization: 'Bearer ' + token.access_token }
+    };
+    const res = await fetch(url, options);
+    if (res.status != 204) {
+        logger.error('Failed to delete Typeform webhook', { status: res.status, body: res.text() });
+        throw new Error('Failed to delete Typeform webhook');
+    }
+    else {
+        logger.info('Deleted Typeform webhook', { webhookTag });
+    }
+}
+
+const createWebhook = async (formId: string, tag: string, token: TypeformAccessToken, webhookUrl: string, logger: Logger): Promise<TypeformWebhook> => {
+    const url = `https://api.typeform.com/forms/${formId}/webhooks/${tag}`;
+
+    const options = {
+        method: 'PUT',
+        headers: { 'Content-Type': 'application/json', Authorization: 'Bearer ' + token.access_token },
+        body: JSON.stringify({
+            enabled: true,
+            event_types: {
+                form_response_partial: true,
+                form_response: true
+            },
+            url: webhookUrl,
+            secret: process.env.TYPEFORM_WEBHOOK_SECRET as string,
+            verify_ssl: true
+        } as TypeformWebhookCreate)
+    };
+    const res = await fetch(url, options);
+    if (res.status != 200) {
+        logger.error('Failed to create Typeform webhook', { status: res.status, body: res.text() });
+        throw new Error('Failed to create Typeform webhook');
+    }
+    else {
+        logger.info('Created Typeform webhook', { webhookUrl });
+        return (await res.json()) as TypeformWebhook;
+    }
+}
+
+const listWebhooks = async (formId: string, token: TypeformAccessToken, logger: Logger): Promise<TypeformWebhook[]> => {
+    const url = `https://api.typeform.com/forms/${formId}/webhooks`;
+
+    const options = {
+        method: 'GET',
+        headers: {
+            'Content-Type': 'application/json',
+            Authorization: 'Bearer ' + token.access_token
+        }
+    };
+    const res = await fetch(url, options);
+    if (res.status != 200) {
+        logger.error('Failed to list Typeform webhooks', { status: res.status, body: res.text(), headers: res.headers });
+        return [];
+    }
+    const json = (await res.json()) as TypeformListWebhookResponse;
+
+    return json.items;
+}
+
+export interface TypeformWebhook {
+    created_at: string
+    enabled: boolean;
+    verify_ssl: boolean;
+    event_types: TypeformWebhookEventTypes
+    form_id: string
+    id: string
+    tag: string
+    url: string
+    updated_at: string
+}
+
+export interface TypeformWebhookEventTypes {
+    form_response: boolean
+    form_response_partial: boolean
+}
+
+export interface TypeformWebhookCreate {
+    enabled: boolean;
+    event_types: TypeformWebhookEventTypes
+    secret: string
+    url: string
+    verify_ssl: boolean;
+}
+
+export interface TypeformListWebhookResponse {
+    items: TypeformWebhook[]
+}

package/dist/ai-context/internal/examples/v2/typeform/app/server/tsconfig.json

@@ -0,0 +1,18 @@
+{
+  "compilerOptions": {
+    "allowJs": true,
+    "skipLibCheck": true,
+    "strict": false,
+    "esModuleInterop": true,
+    "outDir": "dist",
+    "rootDir": ".",
+    "sourceMap": true,
+    "module": "CommonJS",
+    "target": "ES6",
+    "resolveJsonModule": true,
+    "isolatedModules": false,
+  },
+  "include": [
+    "src/functions/*.ts"
+  ]
+}

package/dist/ai-context/internal/examples/v2/typeform/app/ui/README.md

@@ -0,0 +1,40 @@
+# Material UI - Create React App example in TypeScript
+
+## How to use
+
+Download the example [or clone the repo](https://github.com/mui/material-ui):
+
+<!-- #default-branch-switch -->
+
+```bash
+curl https://codeload.github.com/mui/material-ui/tar.gz/master | tar -xz --strip=2 material-ui-master/examples/material-ui-cra-ts
+cd material-ui-cra-ts
+```
+
+Install it and run:
+
+```bash
+npm install
+npm start
+```
+
+or:
+
+<!-- #default-branch-switch -->
+
+[![Edit on CodeSandbox](https://codesandbox.io/static/img/play-codesandbox.svg)](https://codesandbox.io/p/sandbox/github/mui/material-ui/tree/master/examples/material-ui-cra-ts)
+
+[![Edit on StackBlitz](https://developer.stackblitz.com/img/open_in_stackblitz.svg)](https://stackblitz.com/github/mui/material-ui/tree/master/examples/material-ui-cra-ts)
+
+## The idea behind the example
+
+This example demonstrates how you can use Material UI with [Create React App](https://github.com/facebookincubator/create-react-app) in [TypeScript](https://github.com/Microsoft/TypeScript).
+It includes `@mui/material` and its peer dependencies, including [Emotion](https://emotion.sh/docs/introduction), the default style engine in Material UI v6.
+If you prefer, you can [use styled-components instead](https://mui.com/material-ui/integrations/interoperability/#styled-components).
+
+## What's next?
+
+<!-- #default-branch-switch -->
+
+You now have a working example project.
+You can head back to the documentation and continue by browsing the [templates](https://mui.com/material-ui/getting-started/templates/) section.

package/dist/ai-context/internal/examples/v2/typeform/app/ui/index.html

@@ -0,0 +1,22 @@
+<!DOCTYPE html>
+<html lang="en">
+
+<head>
+    <meta charset="UTF-8" />
+    <link rel="icon" href="/favicon.ico" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>Seeka Typeform</title>
+    <!-- Fonts to support Material Design -->
+    <link rel="preconnect" href="https://fonts.googleapis.com" />
+    <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
+    <link href="https://fonts.googleapis.com/css2?family=Roboto:wght@300;400;500;700&display=swap" rel="stylesheet" />
+    <script type="module" src="/src/index.tsx"></script>
+    <script vite-ignore src="%VITE_BASE_URL%config.js?c=%VITE_RELEASE_TAG%"></script>
+</head>
+
+<body>
+    <noscript>You need to enable JavaScript to run this app.</noscript>
+    <div id="root"></div>
+</body>
+
+</html>

package/dist/ai-context/internal/examples/v2/typeform/app/ui/package.json

@@ -0,0 +1,72 @@
+{
+  "name": "@seeka-app-typeform/ui",
+  "version": "2.1.4",
+  "description": "Seeka app seeka-app-typeform",
+  "author": "Seeka <administrator@seeka.co>",
+  "license": "MIT",
+  "homepage": "/app",
+  "private": true,
+  "dependencies": {
+    "@emotion/react": "11.14.0",
+    "@emotion/styled": "11.14.1",
+    "@hookform/resolvers": "^4.1.3",
+    "@mui/icons-material": "6.5.0",
+    "@mui/lab": "6.0.1-beta.34",
+    "@mui/material": "6.5.0",
+    "@mui/styles": "^6.4.11",
+    "@mui/system": "^6.4.11",
+    "@reduxjs/toolkit": "2.8.2",
+    "@seeka-app-typeform/lib": "2.1.4",
+    "@seeka-labs-internal/lib-api-app": "^3.0.31-alpha.0",
+    "@seeka-labs-internal/lib-react-common": "^3.0.31-alpha.0",
+    "@seeka-labs/converge": "^1.8.87",
+    "@seeka-labs/sdk-apps-core": "2.0.20-alpha.0",
+    "lodash-es": "^4.17.21",
+    "material-ui-confirm": "^3.0.18",
+    "moment": "^2.30.1",
+    "moment-duration-format": "^2.3.2",
+    "notistack": "^3.0.2",
+    "query-string": "^9.2.2",
+    "react": "18.3.1",
+    "react-dom": "18.3.1",
+    "react-hook-form": "^7.60.0",
+    "react-redux": "^9.2.0",
+    "react-router-dom": "^7.7.0",
+    "redux": "^5.0.1",
+    "redux-persist": "^6.0.0",
+    "uuid": "^11.1.0",
+    "yup": "^1.6.1"
+  },
+  "devDependencies": {
+    "@types/fs-extra": "^11",
+    "@types/lodash-es": "^4.17.12",
+    "@types/react": "18.3.1",
+    "@types/react-dom": "18.3.1",
+    "@vitejs/plugin-react": "^4.6.0",
+    "cross-env": "^7.0.3",
+    "fs-extra": "^11.3.0",
+    "rimraf": "6.0.1",
+    "typescript": "5.8.3",
+    "vite": "^7.0.5"
+  },
+  "scripts": {
+    "start": "vite",
+    "clean": "rimraf build package dist",
+    "dev": "cross-env NODE_ENV=development cross-env VITE_RELEASE_TAG=$(date +%Y%m%d%H%M%S) cross-env VITE_BASE_URL=/app/ vite",
+    "build": "vite build && rimraf ../server/dist/src/ui && mkdir ../server/dist/src/ui -p && cp -r build/ ../server/dist/src/ui",
+    "build:dev": "cross-env NODE_ENV=development VITE_RELEASE_TAG=$(date +%Y%m%d%H%M%S) VITE_BASE_URL=/app/ vite build --watch",
+    "preview": "vite preview"
+  },
+  "browserslist": {
+    "production": [
+      ">0.2%",
+      "not dead",
+      "not op_mini all"
+    ],
+    "development": [
+      "last 1 chrome version",
+      "last 1 firefox version",
+      "last 1 safari version"
+    ]
+  }
+}

package/dist/ai-context/internal/examples/v2/typeform/app/ui/src/App.tsx

@@ -0,0 +1,79 @@
+import Box from '@mui/material/Box';
+import { ConfirmProvider } from 'material-ui-confirm';
+import * as React from 'react';
+import {
+  createBrowserRouter,
+  Outlet,
+  RouterProvider,
+} from "react-router-dom";
+import { Index } from './routes/home';
+import { SeekaCoreApiReduxProvider } from './seeka-labs-app-sdk-ui/api/redux';
+import { TokenProvider } from './seeka-labs-app-sdk-ui/shared/auth/tokenProvider';
+
+import type { TypeformFormBinding } from '@seeka-app-typeform/lib';
+
+let basename = (import.meta as any).env.BASE_URL
+// trim last /
+basename = basename.substring(0, basename.length - 1);
+
+function AppLayout() {
+  return (
+    <TokenProvider>
+      <SeekaCoreApiReduxProvider>
+        <ConfirmProvider>
+          <Outlet />
+        </ConfirmProvider>
+      </SeekaCoreApiReduxProvider>
+    </TokenProvider>
+  );
+}
+
+const router = createBrowserRouter([
+  {
+    element: <AppLayout />,
+    children: [
+      { path: '/', element: <Index /> },
+      // other routes…
+    ],
+  },
+], { basename });
+
+declare global {
+  interface Window {
+    seekaAppConfig: {
+      appBaseUrl: string
+      seekaAppId: string;
+      seekaAppInstallId: string;
+      organisationBrandId: string;
+      state: {
+        hasUserAccessToken: boolean
+        formBindings: TypeformFormBinding[]
+      }
+    };
+  }
+}
+
+export default function App() {
+  const [loaded, setLoaded] = React.useState(Boolean(window.seekaAppConfig));
+
+  let interval: any = null;
+  if (!loaded && !interval) {
+    interval = setInterval(() => {
+      setLoaded(Boolean(window.seekaAppConfig || process.env.NODE_ENV === 'development'));
+    }, 200);
+  }
+
+  React.useEffect(() => {
+    if (loaded && interval) {
+      clearInterval(interval);
+    }
+  }, [loaded]);
+
+  return (
+    !loaded ? <></> : (
+      <Box sx={{ my: 4, mx: 2 }}>
+        <RouterProvider router={router} />
+      </Box>
+    )
+  );
+}

package/dist/ai-context/internal/examples/v2/typeform/app/ui/src/components/setup/steps/auth/index.tsx

@@ -0,0 +1,36 @@
+import { TypeformLogin } from "@/components/typeform/login"
+import { SeekaAppWizardHeading } from "@/seeka-labs-app-sdk-ui/wizard/heading"
+import { SeekaAppWizardStep } from "@/seeka-labs-app-sdk-ui/wizard/step"
+import { SeekaAppWizardStepActions } from "@/seeka-labs-app-sdk-ui/wizard/step/actions"
+import { SeekaAppWizardStepContent } from "@/seeka-labs-app-sdk-ui/wizard/step/content"
+import { Button } from "@mui/material"
+import { useState } from "react"
+import typeformAdsIcon from '../../../../assets/typeform-icon.png'
+
+type Props = {
+    onSkip?: () => void
+}
+
+export const TypeformAuthStep = ({ onSkip }: Props) => {
+    const [hasUserAccessToken, setHasUserAccessToken] = useState(window.seekaAppConfig.state?.hasUserAccessToken || false)
+
+    return (
+        <SeekaAppWizardStep>
+            <SeekaAppWizardHeading title="Connect to Typeform" image={typeformAdsIcon}>
+                Connecting your Typeform to Seeka is super easy and can be done in around 3 minutes by anyone with Admin access to Typeform.
+            </SeekaAppWizardHeading>
+            <SeekaAppWizardStepContent title="Instructions" subtitle="Authenticate Typeform">
+                <ol>
+                    <li>Click the Authenticate Typeform button</li>
+                    <li>Select the Typeform account that is authorised to your Typeform account</li>
+                    <li>Follow the guided prompts to authorise Seeka.</li>
+                </ol>
+            </SeekaAppWizardStepContent>
+
+            <SeekaAppWizardStepActions>
+                <TypeformLogin onChange={(u) => setHasUserAccessToken(u)} />
+                {onSkip && hasUserAccessToken && <Button variant='contained' color="primary" onClick={onSkip}>Next</Button>}
+            </SeekaAppWizardStepActions>
+        </SeekaAppWizardStep>
+    )
+}

package/dist/ai-context/internal/examples/v2/typeform/app/ui/src/components/setup/steps/complete/index.tsx

@@ -0,0 +1,22 @@
+import { SeekaAppWizardHeading } from "@/seeka-labs-app-sdk-ui/wizard/heading"
+import { SeekaAppWizardStep } from "@/seeka-labs-app-sdk-ui/wizard/step"
+import { SeekaAppWizardStepActions } from "@/seeka-labs-app-sdk-ui/wizard/step/actions"
+import { Button } from "@mui/material"
+import typeformAdsIcon from '../../../../assets/typeform-icon.png'
+
+type Props = {
+    onBack?: () => void
+}
+
+export const TypeformCompletedStep = ({ onBack }: Props) => {
+    return (
+        <SeekaAppWizardStep>
+            {/* {JSON.stringify(detailedCustomer)} */}
+            <SeekaAppWizardHeading title="Typeform setup complete" image={typeformAdsIcon} />
+
+            <SeekaAppWizardStepActions>
+                <Button variant='text' onClick={onBack}>Back</Button>
+            </SeekaAppWizardStepActions>
+        </SeekaAppWizardStep>
+    )
+}