@seeka-labs/cli-apps 3.7.0 → 3.8.2

package/dist/ai-context/internal/examples/v2/trustarc/app/server-azure-function/src/lib/state/seeka/installations.ts

@@ -0,0 +1,65 @@
+import type { Logger } from 'winston';
+
+import { TrustArcCategoryMapping } from '../../models';
+import { getList, remove, set, tryGet } from '../redis';
+
+export interface SeekaAppInstallState {
+    /** ID of the organisation that installed the app */
+    organisationId: string;
+    /** ID of the brand that installed the app */
+    organisationBrandId: string;
+    /** ID of the installation of the app */
+    applicationInstallId: string;
+    // Installation settings provided by the user installing the app
+    installationSettings: TrustarcAppInstallSettings
+    // State relating to the app and installation of the app
+    installationState: TrustarcAppInstallState;
+
+    // When the app was installed
+    installedAt: string; // new Date().toISOString()
+}
+
+export interface TrustarcAppInstallState {
+    grantedPermissions?: string[]
+}
+
+export type TrustarcAppInstallSettings = { [key: string]: any; } | {
+    categoryMapping: TrustArcCategoryMapping[];
+}
+
+const stateType = 'install'
+
+export const tryGetInstallation = async (applicationInstallId: string, throwWhenNotFound: boolean, logger: Logger): Promise<SeekaAppInstallState | null> => {
+    const installation = await tryGet<SeekaAppInstallState>(stateType, applicationInstallId);
+    if (installation == null && throwWhenNotFound) {
+        throw new Error(`Seeka installation ${applicationInstallId} not found`);
+    }
+
+    return installation;
+}
+
+export const listInstallations = async (logger: Logger): Promise<SeekaAppInstallState[]> => {
+    const installations = await getList<SeekaAppInstallState>(stateType);
+
+    return installations;
+}
+
+
+export const createOrUpdateInstallation = async (state: SeekaAppInstallState, logger: Logger): Promise<SeekaAppInstallState> => {
+    if (!state.installationState) state.installationState = {};
+    if (!state.installedAt) state.installedAt = new Date().toISOString();
+
+    const creating = (await tryGetInstallation(state.applicationInstallId, false, logger)) === null;
+
+    await set(stateType, state.applicationInstallId, state);
+
+    logger.info(creating ? 'Created installation state' : 'Updated installation state', { applicationInstallId: state.applicationInstallId, organisationId: state.organisationId, organisationBrandId: state.organisationBrandId });
+
+    return state;
+}
+
+export const deleteInstallation = async (applicationInstallId: string, logger: Logger): Promise<void> => {
+    await remove(stateType, applicationInstallId);
+
+    logger.info('Deleted installation state', { applicationInstallId });
+}

package/dist/ai-context/internal/examples/v2/trustarc/app/server-azure-function/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/trustarc/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "seeka-app-trustarc",
+  "version": "2.0.1",
+  "private": true,
+  "workspaces": [
+    "app/*"
+  ],
+  "scripts": {
+    "clean": "yarn workspaces foreach --all -pt run clean",
+    "lint": "yarn workspaces foreach --all -pt run lint",
+    "build": "yarn workspace @seeka-app-trustarc/browser run build && yarn workspace @seeka-app-trustarc/server-azure-function run build",
+    "dev": "yarn clean && yarn workspace @seeka-app-trustarc/browser run build:dev && yarn workspace @seeka-app-trustarc/server-azure-function run build && yarn workspace @seeka-app-trustarc/server-azure-function run dev",
+    "deploy": "yarn workspace @seeka-app-trustarc/server-azure-function run deploy",
+    "tunnel": "yarn workspace @seeka-app-trustarc/server-azure-function run tunnel"
+  },
+  "devDependencies": {
+    "azure-functions-core-tools": "^4.x"
+  },
+  "packageManager": "yarn@4.9.1",
+  "description": "Seeka app seeka-app-trustarc - Root",
+  "author": "Seeka company <platform@seeka.co>"
+}

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

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

package/dist/ai-context/internal/examples/v2/typeform/.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/typeform/README.md

@@ -0,0 +1,15 @@
+# Typeform app
+
+## Local dev
+- server + ui
+    - `clear && yarn dev`
+    - separate terminal `clear && yarn dev:server`
+    - separate terminal `clear && yarn dev:ui`
+    - 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/typeform/_ai-summary.md

@@ -0,0 +1,31 @@
+```markdown
+# AI Summary for Seeka Typeform App
+
+## Purpose and Functionality
+The Seeka Typeform app is designed to integrate with Typeform for tracking form submissions and survey responses. It leverages webhooks to capture lead data and survey responses, facilitating real-time data processing and integration with other systems.
+
+## Key Implementation Patterns
+- **Monorepo Structure**: The app uses a monorepo setup managed by Yarn workspaces, allowing for organized development across multiple components (`browser`, `ui`, `server`).
+- **Azure Functions**: The server-side logic is implemented using Azure Functions, providing a scalable and efficient way to handle HTTP requests and webhook events.
+- **Webhook Handling**: The app processes various webhook events such as `AppInstalled`, `AppUninstalled`, and `ActivityAccepted`, ensuring that the app's state is updated accordingly.
+
+## External APIs/Services Integrated
+- **Typeform**: The app integrates with Typeform to receive form submissions and survey responses.
+- **Seeka SDK**: Utilizes the `@seeka-labs/sdk-apps-server` for handling Seeka-specific webhook payloads and validation.
+
+## Important Data Transformations
+- **Webhook Payload Parsing**: Incoming webhook payloads are parsed and validated to ensure they are from trusted sources, using signature validation.
+- **Installation State Management**: The app maintains the state of installations, updating or deleting records based on webhook events.
+
+## Notable Code Patterns
+- **Logging**: Uses Winston for structured logging, providing detailed insights into webhook processing and app state changes.
+- **Service Initialization**: The `startServices` function is invoked to initialize necessary services before processing webhook events.
+- **Error Handling**: Implements robust error handling and logging to manage invalid webhook signatures and unknown installation IDs.
+
+## Reusable Code Patterns
+- **Webhook Signature Validation**: The `throwOnInvalidWebhookSignature` function provides a reusable pattern for validating webhook signatures across different applications.
+- **State Management**: Functions like `createOrUpdateInstallation` and `deleteInstallation` offer a template for managing application state in response to external events.
+- **Logging**: The use of `childLogger` and `webhookLogger` demonstrates a reusable pattern for context-specific logging.
+
+This summary provides an overview of the Seeka Typeform app's architecture and implementation, highlighting its integration with Typeform and the use of Azure Functions for server-side processing. The app's design patterns and external integrations make it a robust solution for managing form submissions and survey responses.
+```

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

@@ -0,0 +1 @@
+# `@seeka-labs/seeka-app-typeform-browser`

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

@@ -0,0 +1,34 @@
+{
+  "name": "@seeka-app-typeform/browser",
+  "version": "2.1.4",
+  "description": "Seeka Typeform app browser plugin seeka-app-typeform-browser",
+  "author": "Seeka company <support@seeka.co>",
+  "license": "MIT",
+  "files": [
+    "dist/"
+  ],
+  "scripts": {
+    "lint": "eslint --fix src/ --ext .ts",
+    "clean": "rimraf dist build package",
+    "build": "yarn clean && node ./scripts/esbuild/build-browser-plugin.mjs seeka-app-typeform TypeformAppConvergeSdkPlugin",
+    "build:dev": "yarn clean && node ./scripts/esbuild/build-browser-plugin.mjs seeka-app-typeform TypeformAppConvergeSdkPlugin dev",
+    "watch": "yarn clean && node ./scripts/esbuild/build-browser-plugin.mjs seeka-app-typeform TypeformAppConvergeSdkPlugin dev watch"
+  },
+  "dependencies": {
+    "@seeka-app-typeform/lib": "2.1.4",
+    "@seeka-labs/converge": "^1.8.87"
+  },
+  "devDependencies": {
+    "@jgoz/esbuild-plugin-typecheck": "^4.0.3",
+    "@types/lodash-es": "^4.17.12",
+    "@types/node": "^20",
+    "@typescript-eslint/eslint-plugin": "^8.37.0",
+    "@typescript-eslint/parser": "^8.37.0",
+    "esbuild": "^0.25.6",
+    "eslint": "^9",
+    "eslint-plugin-unused-imports": "^4.1.4",
+    "rimraf": "^6.0.1",
+    "typescript": "^5.8.3",
+    "watch": "^1.0.2"
+  }
+}

package/dist/ai-context/internal/examples/v2/typeform/app/browser/src/browser.ts

@@ -0,0 +1,12 @@
+import { ITypeformAppBrowserSdkPluginConfig } from "@seeka-app-typeform/lib";
+import { TypeformAppConvergeSdkPlugin } from "./plugin";
+
+declare global {
+  interface Window {
+    TypeformAppConvergeSdkPlugin: (pluginConfig: ITypeformAppBrowserSdkPluginConfig) => TypeformAppConvergeSdkPlugin;
+  }
+}
+
+(window as Window).TypeformAppConvergeSdkPlugin = (pluginConfig: ITypeformAppBrowserSdkPluginConfig) => {
+  return new TypeformAppConvergeSdkPlugin(pluginConfig);
+};

package/dist/ai-context/internal/examples/v2/typeform/app/browser/src/plugin/index.ts

@@ -0,0 +1,197 @@
+
+import {
+  ConvergeSdk,
+  IConvergePlugin
+} from '@seeka-labs/converge';
+
+import { ITypeformAppBrowserSdkPluginConfig } from '@seeka-app-typeform/lib';
+import { dependencies, version } from '../../package.json';
+
+const checkSdkAndPluginVersion = (expectedVersion: string, sdk: ConvergeSdk, pluginName: string): void => {
+  let runtimeVersion = sdk.config.runtime.ver as string;
+  runtimeVersion = runtimeVersion.replace('^', '');
+  expectedVersion = expectedVersion.replace('^', '');
+
+  if (expectedVersion !== runtimeVersion) {
+    sdk.debug.warn(`The expected SDK version of ${expectedVersion} for the ${pluginName} plugin does not match the current installlation runtime of ${runtimeVersion}`);
+  }
+}
+
+export class TypeformAppConvergeSdkPlugin implements IConvergePlugin<ITypeformAppBrowserSdkPluginConfig> {
+  constructor(pluginConfig: ITypeformAppBrowserSdkPluginConfig) {
+    this.type = "seeka-app-typeform";
+    // this.name = this.type + "-" + pluginConfig.siteId;
+    this.name = this.type;
+    this.version = version;
+    this.sdk = {} as ConvergeSdk;
+    this.config = pluginConfig || {};
+  }
+  sdk: ConvergeSdk;
+
+  privacyConfig = {
+    // TODO
+    requiresIabPurposes: []
+  }
+
+  name: string;
+  type: string;
+  version: string;
+  config: ITypeformAppBrowserSdkPluginConfig;
+  bindedWidgetPopupOpeningListener: boolean = false;
+  typeformFormDomain = 'form.typeform.com';
+
+  async init(_params: any): Promise<void> {
+    // console.log('heree loaded typeform')
+    checkSdkAndPluginVersion(dependencies['@seeka-labs/converge'], this.sdk, this.name)
+
+    setTimeout(() => {
+      this.ensureCrossDomainTrackingAdded();
+    }, 100);
+
+    setTimeout(() => {
+      this.ensureCrossDomainTrackingAdded();
+    }, 1300);
+  }
+
+  async beforeInit(): Promise<void> {
+    try {
+      this.bindWidgetPopupOpeningListener();
+    }
+    catch (err) {
+      this.sdk.debug.error('Typeform - Error binding widget popup opening listener', err);
+      setTimeout(() => {
+        this.bindWidgetPopupOpeningListener();
+      }, 2000);
+    }
+
+    setTimeout(() => {
+      this.ensureCrossDomainTrackingAdded();
+    }, 1);
+  }
+
+  private ensureCrossDomainTrackingAdded() {
+    // Check embeds of Typeform iframes without popups
+    this.sdk.debug.verbose('Typeform - Checking for iframes without cross domain tracking');
+    const iframes = this.findTypeformIframes(document.body);
+    this.addCrossDomainTrackingToIframe(iframes, 'initial');
+
+    const links = this.findTypeformLinks(document.body);
+    this.addCrossDomainTrackingToFormLinks(links, 'initial');
+  }
+
+  private findTypeformIframes(rootNode: HTMLElement): NodeListOf<HTMLIFrameElement> | null {
+    if (!rootNode || !rootNode['querySelectorAll']) return null;
+    const iframe: NodeListOf<HTMLIFrameElement> = rootNode.querySelectorAll('iframe[src*="form.typeform.com"]');
+
+    return iframe;
+  }
+
+  private findTypeformLinks(rootNode: HTMLElement): NodeListOf<HTMLAnchorElement> | null {
+    if (!rootNode) return null;
+
+    const links: NodeListOf<HTMLAnchorElement> = document
+      .querySelectorAll('[href*="' + this.typeformFormDomain.replace(/\./g, "\\.") + '"]');
+
+    if (links.length === 0) return null;
+
+    return links;
+  }
+
+  private bindWidgetPopupOpeningListener() {
+    if (this.bindedWidgetPopupOpeningListener) return;
+    const config = { attributes: true, childList: true };
+
+    this.sdk.debug.verbose('Typeform - Binding widget popup opening listener');
+
+    let observer: MutationObserver;
+    const callback = (mutationsList) => {
+      for (var mutation of mutationsList) {
+        if (mutation.type == 'childList') {
+          if (mutation.addedNodes.length > 0) {
+            mutation.addedNodes.forEach((node: HTMLElement) => {
+              const iframes = this.findTypeformIframes(node);
+              this.addCrossDomainTrackingToIframe(iframes, 'domObserver');
+            })
+          }
+        }
+      }
+    };
+
+    observer = new MutationObserver(callback);
+    observer.observe(document.body, config);
+    // observer.disconnect();
+
+    this.bindedWidgetPopupOpeningListener = true;
+  }
+
+  private addCrossDomainTrackingToIframe(iframes: NodeListOf<HTMLIFrameElement> | null, srcName: string) {
+    if (!iframes) return;
+
+    iframes.forEach((iframe) => {
+      if (iframe) {
+        iframe.style.visibility = 'hidden';
+
+        try {
+          if (iframe.attributes.getNamedItem('data-sk-iframe-xdomain')?.value === 'true') {
+            this.sdk.debug.verbose('Typeform - Cross domain tracking already added to iframe', { src: iframe.src, srcName });
+            return;
+          }
+
+          let newSrc = this.sdk.attribution.addCrossDomainTracking(iframe.src);
+          newSrc += (newSrc.includes('?') ? '&' : '?') + 'seeka_person_id=' + this.sdk.identity.personId;
+          iframe.src = newSrc;
+
+          iframe.setAttribute('data-sk-iframe-xdomain', 'true');
+
+          if (iframe.parentNode) {
+            if (iframe.parentNode.parentNode) {
+              (iframe.parentNode.parentNode as HTMLElement).style.visibility = ''
+            }
+            else {
+              (iframe.parentNode as HTMLElement).style.visibility = ''
+            }
+          }
+          this.sdk.debug.verbose('Typeform - Added cross domain tracking to iframe - ' + srcName, { src: iframe.src, srcName });
+        }
+        finally {
+          iframe.style.visibility = '';
+        }
+      }
+    })
+  }
+
+  private addCrossDomainTrackingToFormLinks(links: NodeListOf<HTMLAnchorElement> | null, srcName: string) {
+    if (!links) return;
+
+    links.forEach((link) => {
+      if (link) {
+        try {
+          if (link.attributes.getNamedItem('data-sk-link-xdomain')?.value === 'true') {
+            this.sdk.debug.verbose('Typeform - Cross domain tracking already added to link', { href: link.href, srcName });
+            return;
+          }
+
+          let newSrc = this.sdk.attribution.addCrossDomainTracking(link.href);
+          // let newSrc = link.href;
+          newSrc += (newSrc.includes('?') ? '&' : '?') + 'seeka_person_id=' + this.sdk.identity.personId;
+          link.href = newSrc;
+
+          link.setAttribute('data-sk-link-xdomain', 'true');
+
+          this.sdk.debug.verbose('Typeform - Added cross domain tracking to link - ' + srcName, { href: link.href, srcName });
+        }
+        catch (err) {
+          this.sdk.debug.error('Typeform - Error adding cross domain tracking to link', err);
+        }
+      }
+    })
+  }
+
+  // async onProfileChanged(profile: PersonIdentifiers): Promise<void> {
+  //   console.log('Typeform form data', (window as any).rendererData.form.variables);
+  // }
+
+  isLoaded(): boolean {
+    return true;
+  }
+}

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

@@ -0,0 +1,34 @@
+{
+  "compilerOptions": {
+    "allowJs": false,
+    "target": "ESNext",
+    "module": "ESNext",
+    "resolveJsonModule": true,
+    "moduleResolution": "node",
+    "noEmit": true,
+    "strict": true,
+    "noImplicitAny": false,
+    "strictNullChecks": true,
+    "strictFunctionTypes": true,
+    "noUnusedLocals": false,
+    "noUnusedParameters": false,
+    "noImplicitReturns": true,
+    "noFallthroughCasesInSwitch": true,
+    "importHelpers": true,
+    "skipLibCheck": true,
+    "esModuleInterop": true,
+    "allowSyntheticDefaultImports": true,
+    "experimentalDecorators": true,
+    "sourceMap": true,
+    "types": [
+      "node"
+    ],
+    "lib": [
+      "ES6",
+      "DOM"
+    ]
+  },
+  "include": [
+    "src/browser.ts",
+  ]
+}

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

@@ -0,0 +1,32 @@
+{
+  "name": "@seeka-app-typeform/lib",
+  "version": "2.1.4",
+  "description": "Seeka app seeka-app-typeform",
+  "author": "Seeka <administrator@seeka.co>",
+  "license": "MIT",
+  "private": true,
+  "files": [
+    "dist/"
+  ],
+  "types": "./dist/lib/types/index.d.ts",
+  "source": "src/index.ts",
+  "main": "./dist/lib/seeka-app-typeform-lib.module.js",
+  "module": "./dist/lib/seeka-app-typeform-lib.module.js",
+  "devDependencies": {
+    "@seeka-labs/sdk-apps-server": "2.0.20-alpha.0",
+    "@types/lodash-es": "^4.17.12",
+    "@types/node": "20",
+    "esbuild": "^0.25.7",
+    "lodash-es": "^4.17.21",
+    "rimraf": "^6.0.1",
+    "typescript": "^5.8.3"
+  },
+  "peerDependencies": {
+    "lodash-es": "^4"
+  },
+  "scripts": {
+    "clean": "rimraf build package dist",
+    "build": "yarn esbuild src/index.ts --outfile=dist/lib/seeka-app-typeform-lib.module.js --bundle --analyze --platform=node --format=esm --packages=external --minify --sourcemap && yarn tsc --emitDeclarationOnly",
+    "dev": "yarn esbuild src/index.ts --outfile=dist/lib/seeka-app-typeform-lib.module.js --bundle --analyze --platform=node --format=esm --packages=external --sourcemap && yarn tsc --emitDeclarationOnly"
+  }
+}

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

@@ -0,0 +1,2 @@
+
+export * from './models';

package/dist/ai-context/internal/examples/v2/typeform/app/lib/src/models/index.ts

@@ -0,0 +1,23 @@
+
+export interface ITypeformAppBrowserSdkPluginConfig {
+    myAppInstallSetting1: string | number | undefined;
+    myAppInstallSetting2: string | number | undefined;
+    appId: string
+    appInstallId: string
+    appUrl: string
+}
+
+export type TypeformFormBindingWebhookBind = {
+    formId: string;
+    webhookTag: string;
+}
+
+export type TypeformAppInstallSettings = {
+
+}
+
+export type TypeformFormBinding = {
+    typeFormFormId: string
+    id: string
+    formSubmitEventName: string
+}

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

@@ -0,0 +1,22 @@
+{
+  "compilerOptions": {
+    "target": "ESNext",
+    "module": "ESNext",
+    "lib": ["ESNext"],
+    "declarationDir": "./dist/lib/types",
+    "declarationMap": true,
+    "allowJs": true,
+    "skipLibCheck": true,
+    "esModuleInterop": true,
+    "allowSyntheticDefaultImports": true,
+    "strict": true,
+    "forceConsistentCasingInFileNames": true,
+    "noFallthroughCasesInSwitch": true,
+    "removeComments": true,
+    "moduleResolution": "node",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "declaration": true
+  },
+  "include": ["src"]
+}

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

@@ -0,0 +1,19 @@
+/* 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-explicit-any": "off"
+    },
+    overrides: [
+        {
+            files: ["**/*/*.test.ts"],
+            env: {
+                jest: true
+            }
+        }
+    ]
+};

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

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