@seeka-labs/cli-apps 3.7.0 → 3.8.2

package/dist/ai-context/internal/examples/v1/transcend/src/lib/state/seeka/installations.ts

@@ -0,0 +1,64 @@
+import type { Logger } from 'winston';
+
+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: TranscendAppInstallSettings
+    // State relating to the app and installation of the app
+    installationState: TranscendAppInstallState;
+
+    // When the app was installed
+    installedAt: string; // new Date().toISOString()
+}
+
+export interface TranscendAppInstallState {
+    grantedPermissions?: string[]
+}
+
+export type TranscendAppInstallSettings = { [key: string]: any; } | {
+
+}
+
+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/v1/transcend/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/_index.md

@@ -0,0 +1,66 @@
+# V2 Example Apps
+
+> **⚠️ Legacy Version**: V2 apps use an older Azure Functions model. Reference these for feature implementation patterns, but use V3 structure for new apps.
+
+## Overview
+
+V2 example apps demonstrate feature implementations using the monorepo structure with Azure Functions V3 programming model.
+
+## Available Examples
+
+
+### calendly
+- **Template**: azurefunc
+- **Components**: browser, ui, server
+- **Description**: Calendly integration app for tracking meeting bookings and scheduling events from Calendly.
+- **Tags**: scheduling, meetings, webhooks, CRM
+- **Path**: `./calendly/`
+
+
+<!-- Example entries will be added here by the import script:
+
+### meta-capi-v2
+- **Template**: azurefunc
+- **Components**: server, browser
+- **Description**: Meta Conversions API integration
+- **Tags**: conversion-api, ads-platform
+- **Path**: `./meta-capi-v2/`
+
+-->
+
+## When to Reference V2 Apps
+
+V2 apps are useful for understanding:
+
+- **Monorepo patterns**: Workspace organization (similar to V3)
+- **Shared library usage**: How `app/lib` is structured
+- **UI component patterns**: React-based configuration UIs
+- **Browser plugin architecture**: Plugin structure and communication
+- **Complex integrations**: Multi-component app patterns
+
+## Key Differences from V3
+
+| Aspect | V2 | V3 |
+|--------|----|----|
+| Azure Functions | V3 programming model | V4 programming model |
+| Function exports | Default exports | Named exports with `app.http()` |
+| Bindings | `function.json` files | Code-based configuration |
+| Logging | Basic console/context | Winston structured logging |
+
+## Adapting V2 Code to V3
+
+When using V2 code as reference:
+
+1. Remove `function.json` files - V3 uses code-based configuration
+2. Update function signatures to return `HttpResponseInit`
+3. Convert default exports to named exports with `app.http()`
+4. Replace `context.log` with Winston logger
+5. Update SDK packages to latest versions
+
+See `../../architecture/v2-structure.md` for detailed migration guidance.
+
+## See Also
+
+- `../v3/` - Current template examples (use for new apps)
+- `../v1/` - V1 legacy examples
+- `../../architecture/v2-structure.md` - V2 structure documentation

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

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

@@ -0,0 +1,35 @@
+# AI Summary for Calendly Integration App
+
+## Overview
+
+The Calendly integration app is designed to facilitate the tracking of meeting bookings and scheduling events from Calendly. It integrates with Calendly to manage scheduling and is built using Azure Functions as its serverless backend. The app is structured with components for the browser, UI, and server, and it leverages webhooks to interact with the Calendly API and other services.
+
+## Key Implementation Patterns
+
+- **Monorepo Structure**: The app uses a monorepo setup managed by Yarn workspaces, allowing for organized development and deployment of multiple components (`lib`, `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 webhooks.
+- **Webhook Handling**: The app processes various webhook events from Seeka and Calendly, including installation, uninstallation, and settings updates.
+- **Logging**: Utilizes the `winston` library for structured logging, which is crucial for debugging and monitoring webhook interactions.
+
+## External APIs/Services Integrated
+
+- **Calendly API**: The app integrates with Calendly to manage scheduling and event tracking.
+- **Seeka SDK**: Utilizes the Seeka SDK for handling webhook payloads and managing app installations.
+
+## Important Data Transformations
+
+- **Webhook Payload Parsing**: The app parses JSON payloads from incoming webhooks to extract necessary information for processing events.
+- **Installation State Management**: Transforms webhook payloads into installation states, updating or deleting installations as necessary.
+
+## Notable Code Patterns
+
+- **Webhook Signature Validation**: Implements a security pattern to validate webhook signatures, ensuring that requests are authentic.
+- **Conditional Logic for Webhook Types**: Uses a switch-case structure to handle different types of webhook events, providing a clear and maintainable approach to event processing.
+- **Error Handling**: Comprehensive error handling is implemented to catch and log exceptions during webhook processing, enhancing reliability.
+
+## Development and Deployment
+
+- **Scripts for Development**: The `package.json` includes scripts for building, cleaning, linting, and deploying the app, as well as for version management using semantic versioning.
+- **Local Development Setup**: Instructions for setting up a local development environment are provided, including commands for running the server, UI, and tunneling services.
+
+This summary provides an overview of the app's architecture, key features, and implementation details, which can be useful for AI systems to understand and reference the app's functionality and design patterns.

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

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

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

@@ -0,0 +1,33 @@
+{
+  "name": "@seeka-app-calendly/browser",
+  "version": "2.0.1",
+  "description": "Seeka Calendly app browser plugin seeka-app-calendly-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-calendly CalendlyConvergeSdkPlugin",
+    "build:dev": "yarn clean && node ./scripts/esbuild/build-browser-plugin.mjs seeka-app-calendly CalendlyConvergeSdkPlugin dev",
+    "watch": "yarn clean && node ./scripts/esbuild/build-browser-plugin.mjs seeka-app-calendly CalendlyConvergeSdkPlugin dev watch"
+  },
+  "dependencies": {
+    "@seeka-app-calendly/lib": "2.0.1",
+    "@seeka-labs/converge": "^1.8.89"
+  },
+  "devDependencies": {
+    "@jgoz/esbuild-plugin-typecheck": "^4.0.3",
+    "@types/lodash-es": "^4.17.12",
+    "@typescript-eslint/eslint-plugin": "^8.38.0",
+    "@typescript-eslint/parser": "^8.38.0",
+    "esbuild": "^0.25.8",
+    "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/calendly/app/browser/src/browser.ts

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

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

@@ -0,0 +1,164 @@
+
+import {
+  ConvergeSdk,
+  IConvergePlugin,
+  TrackingActivityNames, getActivityName
+} from '@seeka-labs/converge';
+
+import type { EnrichSeekaProfileFromCalendlyRequest, ICalendlyBrowserSdkPluginConfig } from '@seeka-app-calendly/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.verbose(`The expected SDK version of ${expectedVersion} for the ${pluginName} plugin does not match the current installlation runtime of ${runtimeVersion}`);
+  }
+}
+
+export class CalendlyConvergeSdkPlugin implements IConvergePlugin<ICalendlyBrowserSdkPluginConfig> {
+  constructor(pluginConfig: ICalendlyBrowserSdkPluginConfig) {
+    this.type = "seeka-app-calendly";
+    this.name = this.type + "-" + pluginConfig.appInstallId;
+    this.version = version;
+    this.sdk = {} as ConvergeSdk;
+    this.config = pluginConfig || {};
+  }
+  sdk: ConvergeSdk;
+
+  privacyConfig = {
+    // TODO
+    requiresIabPurposes: []
+  }
+
+  name: string;
+  type: string;
+  version: string;
+  config: ICalendlyBrowserSdkPluginConfig;
+
+  async init(_params: any): Promise<void> {
+    window.addEventListener('message', async (event) => {
+      if (event.origin === 'https://calendly.com') {
+        await this.handleCalendlyEvent(event);
+      }
+    })
+
+    checkSdkAndPluginVersion(dependencies['@seeka-labs/converge'], this.sdk, this.name)
+  }
+
+  private async handleCalendlyEvent(event: any) {
+    const eventType = event.data.event;
+    if (!eventType || eventType.indexOf('calendly.') !== 0) return;
+
+    this.sdk.debug.verbose("Calendly event received", { eventType, event })
+    switch (eventType) {
+      case 'calendly.date_and_time_selected':
+        // this.sdk.track.custom(activityNameCustom, {
+        //   activityIdentifier: activityId,
+        //   contentId: eventId
+        // })
+        break;
+      case 'calendly.event_type_viewed':
+        break;
+      case 'calendly.event_scheduled':
+        {
+          let activityName: TrackingActivityNames;
+          let activityNameCustom: string = '';
+
+          if (this.config?.tracking?.eventBookedEventName?.inputValue) {
+            activityName = getActivityName(this.config.tracking?.eventBookedEventName?.inputValue);
+            if (activityName === TrackingActivityNames.Custom) {
+              activityNameCustom = this.config.tracking?.eventBookedEventName?.inputValue;
+            }
+          }
+          else {
+            activityName = TrackingActivityNames.Custom;
+            activityNameCustom = 'CalendlyInviteCreated';
+          }
+
+          const activityId = this.getEventId(event.data.payload)
+          const eventId = event.data.payload.event.uri.split('/').splice(-1)[0];
+
+          const promises: Promise<void>[] = [];
+
+          switch (activityName) {
+            case TrackingActivityNames.Custom: {
+              promises.push(this.sdk.track.custom(activityNameCustom, {
+                activityIdentifier: activityId,
+                contentId: eventId
+              }));
+              break;
+            }
+            default: {
+              promises.push(this.sdk.track.activity(activityName, {
+                activityIdentifier: activityId,
+                contentId: eventId
+              }));
+              break;
+            }
+          }
+
+          promises.push(this.sendAttendeeToApp(event.data.payload));
+          await Promise.all(promises);
+
+          break;
+        }
+    }
+  }
+
+  private async sendAttendeeToApp(payload: any): Promise<void> {
+    try {
+      const eventId = payload.event.uri
+      const inviteeId = payload.invitee.uri;
+
+      const beaconUrl = `${this.config.appUrl}/api/profile/enrich`;
+
+      // if (navigator.sendBeacon && !navigator.sendBeacon(beaconUrl, JSON.stringify(beaconPayload))) {
+      //   this.sdk.debug.warn('Failed to send attendee to Calendly app')
+      // }
+      // else {
+      const res = await fetch(beaconUrl, {
+        method: 'POST',
+        keepalive: true,
+        mode: 'cors',
+        credentials: 'omit',
+        headers: {
+          'Content-Type': 'application/json',
+        },
+        body: JSON.stringify({
+          appId: this.config.appId,
+          appInstallId: this.config.appInstallId,
+          event: eventId,
+          invitee: inviteeId,
+          seekaPersonId: this.sdk.identity.personId,
+        } as EnrichSeekaProfileFromCalendlyRequest)
+      })
+      if (!res.ok) {
+        this.sdk.debug.error('Failed to send attendee to Calendly app')
+      }
+      // }
+    }
+    catch (err) {
+      this.sdk.debug.error('Failed to send attendee to Calendly app', err)
+    }
+  }
+
+  // Should match Seeka developer app for dedupe
+  private getEventId(payload: any) {
+    const eventId = payload.event.uri.split('/').splice(-1)[0];
+    const inviteeId = this.getInviteeId(payload);
+
+    return `calendly_${eventId}_invite_${inviteeId}_created`
+  }
+
+  private getInviteeId(payload: any) {
+    return payload.invitee.uri.split('/').splice(-1)[0];
+  }
+
+  isLoaded(): boolean {
+    return true;
+  }
+}

package/dist/ai-context/internal/examples/v2/calendly/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/calendly/app/lib/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "@seeka-app-calendly/lib",
+  "version": "2.0.1",
+  "description": "Seeka app seeka-app-calendly",
+  "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-calendly-lib.module.js",
+  "module": "./dist/lib/seeka-app-calendly-lib.module.js",
+  "devDependencies": {
+    "esbuild": "^0.25.8",
+    "rimraf": "^6.0.1",
+    "typescript": "^5.8.3"
+  },
+  "scripts": {
+    "clean": "rimraf build package dist",
+    "build": "yarn esbuild src/index.ts --outfile=dist/lib/seeka-app-calendly-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-calendly-lib.module.js --bundle --analyze --platform=node --format=esm --packages=external --sourcemap && yarn tsc --emitDeclarationOnly"
+  }
+}

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

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

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

@@ -0,0 +1,30 @@
+
+export interface ICalendlyBrowserSdkPluginConfig {
+    tracking: CalendlyTrackingSettings
+    appId: string
+    appInstallId: string
+    appUrl: string
+}
+
+export interface EnrichSeekaProfileFromCalendlyRequest {
+    invitee: string
+    event: string
+    seekaPersonId: string
+    appInstallId: string
+    appId: string
+}
+
+export interface TrackingEventInfo {
+    inputValue: string | undefined;
+    isCustomInputValue?: boolean;
+    title: string;
+}
+
+export interface CalendlyTrackingSettings {
+    eventBookedEventName: TrackingEventInfo
+}
+
+export interface CalendlyLinkedUser {
+    owner?: string
+    organisation?: string
+}

package/dist/ai-context/internal/examples/v2/calendly/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/calendly/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/calendly/app/server/.nvmrc

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