@seeka-labs/cli-apps 3.7.0 → 3.8.2

package/dist/ai-context/internal/examples/v2/typeform/app/ui/src/seeka-labs-app-sdk-ui/wizard/heading/index.tsx

@@ -0,0 +1,33 @@
+import { Box, Stack, Typography } from "@mui/material"
+
+type Props = {
+    image?: string
+    title?: string
+    children?: React.ReactNode
+}
+export const SeekaAppWizardHeading = ({ image, title, children }: Props) => {
+    return (
+        <Box>
+            <Stack spacing={2} alignItems="flex-start">
+                <Stack direction="row" spacing={2} alignItems="center">
+                    {image && <Box
+                        component="img"
+                        style={{ height: "40px", width: '40px' }}
+                        src={image}
+                        alt="Typeform logo"
+                    />}
+                    <Typography variant="h4" color="text.primary">
+                        {title}
+                    </Typography>
+                </Stack>
+
+                {children && <Typography
+                    variant="body2"
+                    color="text.secondary"
+                >
+                    {children}
+                </Typography>}
+            </Stack>
+        </Box>
+    )
+}

package/dist/ai-context/internal/examples/v2/typeform/app/ui/src/seeka-labs-app-sdk-ui/wizard/step/actions/index.tsx

@@ -0,0 +1,12 @@
+import { Stack } from "@mui/material"
+
+type Props = {
+    children: React.ReactNode
+}
+export const SeekaAppWizardStepActions = ({ children }: Props) => {
+    return (
+        <Stack alignItems={'center'} justifyContent={'space-between'} sx={{ width: '100%', mt: 1 }} direction={'row'}>
+            {children}
+        </Stack>
+    )
+}

package/dist/ai-context/internal/examples/v2/typeform/app/ui/src/seeka-labs-app-sdk-ui/wizard/step/content/index.tsx

@@ -0,0 +1,24 @@
+import { Box, Stack, Typography } from "@mui/material"
+
+type Props = {
+    title?: string
+    subtitle?: string
+    children: React.ReactNode
+}
+export const SeekaAppWizardStepContent = ({ title, subtitle, children }: Props) => {
+    return (
+        <Box>
+            <Stack spacing={1} alignItems="flex-start" sx={{ width: '100%' }}>
+                {title && <Typography variant="h5" color="text.primary">
+                    {title}
+                </Typography>}
+                <Stack spacing={0} alignItems="flex-start" sx={{ width: '100%' }}>
+                    {subtitle && <Typography variant="subtitle2" color="text.primary">
+                        {subtitle}
+                    </Typography>}
+                    {children}
+                </Stack>
+            </Stack>
+        </Box>
+    )
+}

package/dist/ai-context/internal/examples/v2/typeform/app/ui/src/seeka-labs-app-sdk-ui/wizard/step/index.tsx

@@ -0,0 +1,16 @@
+import { SeekaAppLoadingSpinner } from "@/seeka-labs-app-sdk-ui/shared/loading-spinner"
+import { Box, Stack } from "@mui/material"
+
+type Props = {
+    children?: React.ReactNode
+    loading?: boolean
+}
+export const SeekaAppWizardStep = ({ children, loading }: Props) => {
+    return (
+        loading ? <SeekaAppLoadingSpinner /> : <Box>
+            <Stack spacing={2} sx={{ width: '100%' }} alignItems="flex-start">
+                {children}
+            </Stack>
+        </Box>
+    )
+}

package/dist/ai-context/internal/examples/v2/typeform/app/ui/src/vite-env.d.ts

@@ -0,0 +1,12 @@
+/// <reference types="vite/client" />
+interface ViteTypeOptions {
+    strictImportMetaEnv: unknown
+}
+
+interface ImportMetaEnv {
+    readonly VITE_BASE_URL: string
+}
+
+interface ImportMeta {
+    readonly env: ImportMetaEnv
+}

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

@@ -0,0 +1,35 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "useDefineForClassFields": true,
+    "lib": ["ES2020", "DOM", "DOM.Iterable"],
+    "module": "ESNext",
+    "skipLibCheck": true,
+    "allowJs": true,
+
+    /* Bundler mode */
+    "moduleResolution": "bundler",
+    "allowImportingTsExtensions": true,
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "noEmit": true,
+    "jsx": "react-jsx",
+
+    /* Linting */
+    "strict": true,
+    "noUnusedLocals": false,
+    "noUnusedParameters": false,
+    "noFallthroughCasesInSwitch": true,
+    "forceConsistentCasingInFileNames": true,
+    "esModuleInterop": true,
+    "allowSyntheticDefaultImports": true,
+
+    /* Paths */
+    "baseUrl": ".",
+    "paths": {
+      "@/*": ["src/*"]
+    }
+  },
+  "include": ["src", "vite.config.ts"],
+  "references": [{ "path": "./tsconfig.node.json" }]
+}

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

@@ -0,0 +1,10 @@
+{
+  "compilerOptions": {
+    "composite": true,
+    "skipLibCheck": true,
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "allowSyntheticDefaultImports": true
+  },
+  "include": ["vite.config.ts"]
+}

package/dist/ai-context/internal/examples/v2/typeform/app/ui/vite.config.mts

@@ -0,0 +1,46 @@
+import react from '@vitejs/plugin-react';
+import fs from 'fs-extra';
+import path from 'path';
+import { defineConfig } from 'vite';
+function getBase() {
+    if (!process.env["VITE_BASE_URL"]) {
+        throw new Error("VITE_BASE_URL environment variable is required");
+    }
+    return process.env["VITE_BASE_URL"];
+}
+
+const devMode = process.env.NODE_ENV === 'development';
+
+// https://vitejs.dev/config/
+export default defineConfig({
+    plugins: [
+        react(),
+        ...(!devMode ? [] : [
+            {
+                name: 'copy-ui-to-server',
+                writeBundle() {
+                    const dest = '../server/dist/src/ui/build'
+                    fs.removeSync(dest)
+                    fs.copySync('build', dest)
+                }
+            }
+        ])
+    ],
+    // get exposed to your app as import.meta.env.BASE_URL
+    base: getBase(),
+    build: {
+        outDir: 'build',
+        emptyOutDir: true,
+        sourcemap: devMode ? 'inline' : false,
+        minify: devMode ? false : 'esbuild',
+        watch: devMode ? {} : undefined,
+    },
+    server: {
+        port: 3000,
+    },
+    resolve: {
+        alias: {
+            '@': path.resolve(__dirname, './src'),
+        },
+    },
+})

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

@@ -0,0 +1,29 @@
+{
+  "name": "root",
+  "version": "2.1.4",
+  "private": true,
+  "workspaces": [
+    "app/*"
+  ],
+  "scripts": {
+    "build": "yarn workspace @seeka-app-typeform/lib run build && yarn workspace @seeka-app-typeform/browser run build && yarn workspace @seeka-app-typeform/ui run build && yarn workspace @seeka-app-typeform/server run build",
+    "build:test": "VITE_BASE_URL=/app/ yarn build",
+    "clean": "yarn workspaces foreach --all -pt run clean",
+    "lint": "yarn workspaces foreach --all -pt run lint",
+    "dev": "yarn workspace @seeka-app-typeform/lib run dev && yarn workspace @seeka-app-typeform/server run build && yarn workspace @seeka-app-typeform/browser run watch",
+    "dev:ui": "yarn workspace @seeka-app-typeform/ui run build:dev",
+    "dev:server": "yarn workspace @seeka-app-typeform/server run build && yarn workspace @seeka-app-typeform/server run dev",
+    "watch:server": "yarn workspace @seeka-app-typeform/server run watch",
+    "deploy": "yarn workspace @seeka-app-typeform/server run deploy",
+    "tunnel": "yarn workspace @seeka-app-typeform/server run tunnel",
+    "bump:patch": "yarn git:isclean && yarn workspaces foreach --all version patch --deferred && yarn bump:apply && yarn git:push",
+    "bump:minor": "yarn git:isclean && yarn workspaces foreach --all version minor --deferred && yarn bump:apply && yarn git:push",
+    "bump:major": "yarn git:isclean && yarn workspaces foreach --all version major --deferred && yarn bump:apply && yarn git:push",
+    "bump:apply": "yarn version apply --all",
+    "git:isclean": "bash -c 'if [ -n \"$(git status --porcelain)\" ]; then echo \"✖ Working directory not clean. Commit or stash your changes first.\"; exit 1; fi'",
+    "git:push": "git add -A && git commit -m \"v$(node -p \"require('./package.json').version\")\" && git tag -a v$(node -p \"require('./package.json').version\") -m \"v$(node -p \"require('./package.json').version\")\"",
+    "clean:all": "yarn lerna clean --yes && yarn clean && yarn nx reset && rimraf node_modules",
+    "dev:kill": "taskkill /f /t /im node.exe"
+  },
+  "packageManager": "yarn@4.9.1"
+}

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

@@ -0,0 +1,37 @@
+{
+  "compilerOptions": {
+    "allowJs": true,
+    "skipLibCheck": true,
+    "strict": false,
+    "esModuleInterop": true,
+    "sourceMap": true,
+    "module": "CommonJS",
+    "target": "ES6",
+    "resolveJsonModule": true,
+    "isolatedModules": false,
+    "baseUrl": ".",
+    "paths": {
+      "@seeka-app-webhook/*": [
+        "app/*/src"
+      ]
+    }
+  },
+  "references": [
+    {
+      "path": "app/browser"
+    },
+    {
+      "path": "app/server"
+    },
+    {
+      "path": "app/ui"
+    },
+    {
+      "path": "app/lib"
+    }
+  ],
+  "exclude": [
+    "node_modules",
+    "**/dist"
+  ]
+}

package/dist/ai-context/internal/examples/v2/webhook/.yarnrc.yml

@@ -0,0 +1,11 @@
+nodeLinker: node-modules
+                          
+nmHoistingLimits: workspaces
+
+npmScopes: 
+  seeka-labs: 
+    npmRegistryServer: "https://npm.packages.seeka.services"
+    npmAuthToken: "YqwHeBKR8vi37iclBehBwD5TfXx4LEbp2BHdqrbDkMSd/ZBGunsn9EwT9bfjjiMD"
+  seeka-labs-internal:
+    npmAuthToken: "ZSlF6Gfhg0iLsLUsZeId+u5oggyyv1vf1HM8poCwGcR/5iqeC5notEfzracnncoX0UcYwstctxJBzK2KIld0eA=="
+    npmRegistryServer: "https://npm.packages.seeka.services"

package/dist/ai-context/internal/examples/v2/webhook/README.md

@@ -0,0 +1,14 @@
+# Webhook app
+
+## Local dev
+- server + ui
+    - `clear && yarn dev`
+    - separate terminal `clear && yarn dev:server`
+    - separate terminal `clear && yarn watch:server`
+    - separate terminal `yarn tunnel`
+
+# updating all deps
+```
+cd repo root
+npx npm-check-updates@latest -i --workspaces --target minor && npx npm-check-updates@latest -i --workspaces --target minor --dep peer && npx npm-check-updates@latest -i --workspaces --target latest && npx npm-check-updates@latest -i --workspaces --target latest --dep peer
+```

package/dist/ai-context/internal/examples/v2/webhook/_ai-summary.md

@@ -0,0 +1,26 @@
+# AI Summary for Seeka Webhook App
+
+## Purpose and Functionality
+The Seeka Webhook app is designed to send Seeka activity data to custom webhook endpoints. It facilitates the integration of Seeka's platform with external systems by exporting data through webhooks. The app supports various webhook call types, including app installation, settings updates, and uninstallation.
+
+## Key Implementation Patterns
+- **Azure Functions**: The app is implemented using Azure Functions, which handle HTTP requests for webhook events.
+- **Modular Architecture**: The app is divided into `ui` and `server` components, managed using Yarn workspaces for efficient dependency management and build processes.
+- **Logging**: Utilizes Winston for structured logging, providing detailed logs for debugging and monitoring webhook processing.
+- **Error Handling**: Implements robust error handling with try-catch blocks to manage exceptions during webhook processing.
+
+## External APIs/Services Integrated
+- **Azure Functions**: The app is hosted on Azure Functions, leveraging its serverless capabilities for scalability and ease of deployment.
+- **Seeka SDK**: Integrates with the `@seeka-labs/sdk-apps-server` to handle Seeka-specific webhook payloads and validate webhook signatures.
+
+## Important Data Transformations
+- **Webhook Payload Parsing**: The app parses incoming webhook payloads from JSON strings into structured objects for processing.
+- **Installation Management**: Transforms installation-related data into a consistent format for storage and retrieval, including handling installation state and settings updates.
+
+## Notable Code Patterns
+- **Webhook Signature Validation**: Ensures security by validating webhook signatures using a secret key, preventing unauthorized requests.
+- **Service Initialization**: Uses a `startServices` function to initialize necessary services before processing webhooks, ensuring all dependencies are ready.
+- **Conditional Processing**: Handles different webhook call types using a switch-case pattern, allowing for specific logic execution based on the event type.
+- **Profile Logging**: Utilizes logger profiling to measure execution time for specific operations, aiding in performance monitoring and optimization.
+
+This summary provides an overview of the Seeka Webhook app's architecture, key functionalities, and implementation details, facilitating AI understanding and reference for further development or integration tasks.

package/dist/ai-context/internal/examples/v2/webhook/app/server/.eslintrc.cjs

@@ -0,0 +1,11 @@
+/* eslint-env node */
+module.exports = {
+    extends: ['eslint:recommended', 'plugin:@typescript-eslint/recommended'],
+    parser: '@typescript-eslint/parser',
+    plugins: ['@typescript-eslint'],
+    root: true,
+    rules: {
+        "@typescript-eslint/no-unused-vars": "warn",
+        "@typescript-eslint/no-empty-function": "warn",
+    }
+};

package/dist/ai-context/internal/examples/v2/webhook/app/server/.nvmrc

@@ -0,0 +1 @@
+20

package/dist/ai-context/internal/examples/v2/webhook/app/server/README.md

@@ -0,0 +1,104 @@
+# Seeka app - Azure functions
+
+## Development
+
+- See [Configure your environment](https://learn.microsoft.com/en-us/azure/azure-functions/create-first-function-vs-code-typescript?pivots=nodejs-model-v4#configure-your-environment) for dependencies
+- For emulating Azure storage queues, blobs and tables: `docker run --name azurite -p 10000:10000 -p 10001:10001 -p 10002:10002 --detach mcr.microsoft.com/azure-storage/azurite`
+- Set `AzureWebJobsStorage` setting in local.settings.json to `UseDevelopmentStorage=true`
+    - If not using WSL: 
+    `UseDevelopmentStorage=true`
+    - If using WSL, the following may be required to allow your app to reach Azure storage emulator: 
+
+        Replace `MY-MACHINE-NAME` with your hostname. Below connection string allows running Azurite on your host machine and lets WSL connect to it
+        `DefaultEndpointsProtocol=http;AccountName=devstoreaccount1;AccountKey=Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==;BlobEndpoint=http://MY-MACHINE-NAME.local:10000/devstoreaccount1;QueueEndpoint=http://MY-MACHINE-NAME.local:10001/devstoreaccount1;TableEndpoint=http://MY-MACHINE-NAME.local:10002/devstoreaccount1;`
+- Install Azure Storage explorer and create your queues (see `./src/lib/jobs/index.ts` for `queueNames`). Azure Storage explorer can be used to view your queue items.
+- `yarn install`
+- `yarn dev`
+
+### Debugging
+Supports VSCode debugging via the debugger and utilisation of breakpoints. 
+This is only tested on Linux but may work on Windows. 
+If using Windows then use WSL with an Ubuntu distro for support of attaching the VS code debugger
+
+### Live urls
+You can expose your app locally to the internet via Ngrok to test your app before deploying.
+
+#### Setup
+1. Sign up for a Ngrok account
+2. Get your auth token
+3. `yarn ngrok config add-authtoken [auth token here]` replacing `[auth token]` with the auth token retrieved from your Ngrok dashboard
+
+#### Running
+1. `yarn start` OR start debugging in VSCode
+2. In separate terminal window run `yarn tunnel` and observe the log entry that starts with `Live url exposed`.
+3. Input the URL into your Seeka app configuration as the "Webook URL" via the Seeka UI.
+
+## Included sample functions
+### Seeka app webhook 
+`src/functions/seekaAppWebhook.ts`
+
+Handles inbound webhooks sent from Seeka to your app.
+
+### Queue example 
+`src/functions/queueExample.ts`
+
+Handles taking a message and placing it on an Azure storage queue for later processing. This concept can be used to offload long running operations based on data sent to your app from Seeka and can help to ensure Azure Function time execution limits are respected.
+
+### Polling example 
+`src/functions/pollingExample.ts`
+
+Handles scheduled invoking of a function. This concept can be used to "fan out" long running operations based on data sent to your app from Seeka and can help to ensure Azure Function time execution limits are respected by splitting long running operations into smaller, less time consuming parts.
+
+## Invoking functions
+### Development environment
+Scheduled / timer function: `curl -i -d '{"input": null}' -H "Content-Type: application/json" -X POST http://localhost:7072/admin/functions/pollingExample`
+
+### Azure cloud
+Scheduled / timer function: `curl -i -d '{"input": null}' -H "Content-Type: application/json" -H "x-functions-key: <key from azure portal>" -X POST https://seeka-app-webhook.azurewebsites.net/admin/functions/pollingExample`
+
+See [this doc](https://learn.microsoft.com/en-us/azure/azure-functions/functions-manually-run-non-http?tabs=azure-portal#get-the-master-key) on how to get the functions (master) key
+
+## Logging
+Centralised logging handled by [Winston](https://www.npmjs.com/package/winston). Winston is installed in this template and is also used in the Seeka SDK NPM packages.
+
+[Seq](https://datalust.co/seq) Winston transport is installed in this template (optional).
+
+To configure Seq options, see `_SEQ_` environment variables.
+
+To install Seq on your development machine
+1. Run `docker run --name seq -d --restart=always -e ACCEPT_EULA=Y -p 5341:80 datalust/seq:2024.2`
+2. Update your `LOGGING_SEQ_SERVERURL` environment variable to `http://localhost:5341` or `http://[YOUR MACHINE NAME].local:5341` if using WSL.
+
+If creating an API key for Seq, only permission that is required is `Ingest`.
+
+## State management
+Installations of your app and other state required for your app to function is stored in Redis. Another state provider can be swapped out for Redis, see `src/lib/state/seeka/installations.ts` for the file that manages the state of the installations.
+
+### Upstash (optional)
+If you dont want to use Upstash for Redis then the connection strings in `.env` can be swapped with your Redis instance. 
+
+> If using Upstash then create a database before following the below guide to deploying your AWS lambda function.
+
+> When choosing region - use a region that is closest to the Azure region that your function app is hosted in to reduce latency between the function and the Redis database. 
+
+## Deployment
+This project comes ready to deploy for free to Azure functions with database backed by Redis hosted by Upstash and queues, blobs and tables backed by Azure Storage.
+
+1. Create Azure function app via the portal with below settings
+    - Function app name: seeka-app-webhook
+    - Code or container image: Code
+    - Runtime stack: Node.js
+    - Version: 18 LTS
+    - Region: Closest region to where your upstash "master / write" database is located
+    - Operating system: linux
+    - Hosting: Consumption
+    - Enable public access: On
+2. Set environment variables of the Azure web app - reference local.settings.json "Values" 
+3. `yarn deploy`
+
+### Continuous delivery
+This template includes a GitLab CD pipeline that can be used to trigger deployments of your app when changes are pushed to your Git repository.
+
+## References
+- https://learn.microsoft.com/en-us/azure/storage/common/storage-use-azurite
+- https://learn.microsoft.com/en-us/azure/storage/queues/storage-quickstart-queues-nodejs?tabs=connection-string%2Croles-azure-portal%2Cenvironment-variable-windows%2Csign-in-azure-cli

package/dist/ai-context/internal/examples/v2/webhook/app/server/host.json

@@ -0,0 +1,25 @@
+{
+  "version": "2.0",
+  "logging": {
+    "applicationInsights": {
+      "samplingSettings": {
+        "isEnabled": true,
+        "excludedTypes": "Request"
+      }
+    }
+  },
+  "extensions": {
+    "http": {
+      "routePrefix": ""
+    }
+  },
+  "functionTimeout": "00:10:00",
+  "extensionBundle": {
+    "id": "Microsoft.Azure.Functions.ExtensionBundle",
+    "version": "[4.*, 5.0.0)"
+  },
+  "concurrency": {
+    "dynamicConcurrencyEnabled": true,
+    "snapshotPersistenceEnabled": true
+  }
+}

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

@@ -0,0 +1,50 @@
+{
+    "name": "@seeka-app-webhook/server",
+    "version": "2.3.1",
+    "description": "Seeka app seeka-app-webhook",
+    "author": "Webhook <administrator@seeka.co>",
+    "license": "MIT",
+    "main": "dist/src/functions/*.js",
+    "private": true,
+    "engines": {
+        "node": ">=20"
+    },
+    "scripts": {
+        "lint": "eslint",
+        "build": "tsc",
+        "watch": "tsc -w",
+        "clean": "rimraf dist",
+        "prestart": "yarn clean && yarn build",
+        "dev": "func start --port 7072",
+        "tunnel": "node scripts/ngrok.js seeka-app-webhook-localdev",
+        "deploy": "func azure functionapp publish seeka-app-webhook --no-build --javascript",
+        "dev:queue:create": "node scripts/dev-queue-setup.js webhook-request-inbound-webhook-queue && node scripts/dev-queue-setup.js webhook-request-inbound-webhook-queue-poison"
+    },
+    "dependencies": {
+        "@azure/functions": "^4.7.3",
+        "@azure/storage-queue": "^12.26.0",
+        "@datalust/winston-seq": "^2.0.0",
+        "@redis/client": "^5.6.0",
+        "@redis/json": "^5.6.0",
+        "@seeka-labs/sdk-apps-core": "2.0.20-alpha.0",
+        "@seeka-labs/sdk-apps-server": "2.0.20-alpha.0",
+        "axios": "^1.10.0",
+        "jsonpath-plus": "10.3.0",
+        "jsonwebtoken": "^9.0.2",
+        "lodash": "^4.17.21",
+        "redis": "^5.6.0",
+        "uuid": "^11.1.0",
+        "winston": "^3.17.0"
+    },
+    "devDependencies": {
+        "@types/lodash": "^4.17.17",
+        "@types/lodash-es": "^4.17.12",
+        "@types/node": "^20",
+        "@typescript-eslint/eslint-plugin": "^8.33.0",
+        "@typescript-eslint/parser": "^8.33.0",
+        "eslint": "^9",
+        "ngrok": "^5.0.0-beta.2",
+        "rimraf": "^6.0.1",
+        "typescript": "^5.8.3"
+    }
+}

package/dist/ai-context/internal/examples/v2/webhook/app/server/src/functions/healthCheck.ts

@@ -0,0 +1,14 @@
+import { app, HttpRequest, HttpResponseInit, InvocationContext } from '@azure/functions';
+
+app.http('healthCheck', {
+    methods: ['GET', 'HEAD'],
+    authLevel: 'anonymous',
+    route: 'api/health',
+    handler: healthCheck
+});
+
+export async function healthCheck(req: HttpRequest, context: InvocationContext): Promise<HttpResponseInit> {
+    return {
+        status: 200
+    }
+}