@seeka-labs/cli-apps 3.7.0 → 3.8.2

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

@@ -0,0 +1,29 @@
+{
+  "name": "root",
+  "version": "2.0.4",
+  "private": true,
+  "workspaces": [
+    "app/*"
+  ],
+  "scripts": {
+    "build": "yarn workspace @seeka-app-yeastar/lib run build && yarn workspace @seeka-app-yeastar/server run build && yarn workspace @seeka-app-yeastar/ui run build",
+    "clean": "yarn workspaces foreach --all -pt run clean",
+    "lint": "yarn workspaces foreach --all -pt run lint",
+    "dev": "yarn workspace @seeka-app-yeastar/lib run dev && yarn workspace @seeka-app-yeastar/server run build && yarn workspace @seeka-app-yeastar/ui run build:dev",
+    "dev:ui": "yarn workspace @seeka-app-yeastar/ui run build:dev",
+    "dev:server": "yarn workspace @seeka-app-yeastar/server run build && yarn workspace @seeka-app-yeastar/server run dev",
+    "watch:server": "yarn workspace @seeka-app-yeastar/server run watch",
+    "deploy": "yarn workspace @seeka-app-yeastar/server run deploy",
+    "tunnel": "yarn workspace @seeka-app-yeastar/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\")\""
+  },
+  "devDependencies": {
+    "azure-functions-core-tools": "^4.x"
+  },
+  "packageManager": "yarn@4.9.1"
+}

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

@@ -0,0 +1,26 @@
+{
+  "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/server" },
+    { "path": "app/ui" },
+    { "path": "app/lib" }
+  ],
+  "exclude": [
+    "node_modules",
+    "**/dist"
+  ]
+}

package/dist/ai-context/internal/examples/v3/_index.md

@@ -0,0 +1,105 @@
+# V3 Example Apps
+
+> **✅ Current Version**: V3 is the current template version. Use these examples as the primary reference for new app development.
+
+## Overview
+
+V3 example apps demonstrate feature implementations using the current Seeka app template with Azure Functions V4 programming model.
+
+## Available Examples
+
+*No examples imported yet. Use the `ai:context:generate` script to import example apps.*
+
+<!-- Example entries will be added here by the import script:
+
+### google-ads-push
+- **Template**: azurefunc
+- **Components**: server
+- **Description**: Pushes conversion data to Google Ads Conversion API
+- **Tags**: conversion-api, ads-platform
+- **Path**: `./google-ads-push/`
+
+### tiktok-events
+- **Template**: azurefunc
+- **Components**: server, browser
+- **Description**: TikTok Events API integration with browser pixel
+- **Tags**: conversion-api, ads-platform
+- **Path**: `./tiktok-events/`
+
+-->
+
+## V3 Template Features
+
+V3 apps include:
+
+- **Azure Functions V4**: Modern programming model with code-based configuration
+- **Monorepo structure**: Organized workspaces for server, lib, browser, and UI
+- **TypeScript strict mode**: Full type safety
+- **Winston logging**: Structured logging with context
+- **SDK integration**: Full use of `@seeka-labs/sdk-apps-server-host`
+
+## Example Structure
+
+Each V3 example includes:
+
+```
+example-name/
+├── _ai-summary.md          # AI-generated summary of the app
+├── README.md               # Human-readable documentation
+├── app/
+│   ├── server/
+│   │   └── src/
+│   │       ├── functions/  # Azure Function handlers
+│   │       └── app/
+│   │           └── services/  # Business logic
+│   ├── lib/
+│   │   └── src/
+│   │       ├── models/     # Shared types
+│   │       └── validation/ # Settings validation
+│   ├── browser/            # (if applicable)
+│   └── ui/                 # (if applicable)
+└── package.json
+```
+
+## Using V3 Examples
+
+### For New Feature Development
+
+1. Find an example with similar functionality
+2. Review the `_ai-summary.md` for key patterns
+3. Examine the service layer in `app/server/src/app/services/`
+4. Check the models in `app/lib/src/models/`
+5. Adapt the patterns to your app
+
+### For Understanding Patterns
+
+| Pattern | Where to Look |
+|---------|---------------|
+| Webhook handling | `app/server/src/functions/seekaAppWebhook.ts` |
+| External API calls | `app/server/src/app/services/` |
+| Data transformation | `app/server/src/app/services/` |
+| Settings validation | `app/lib/src/validation/` |
+| Queue processing | `app/server/src/functions/*QueueHandler.ts` |
+| Browser plugins | `app/browser/src/plugin/` |
+
+## Common Tags
+
+Examples are tagged for easy discovery:
+
+| Tag | Description |
+|-----|-------------|
+| `conversion-api` | Conversion API integrations (Meta, Google, TikTok) |
+| `ads-platform` | Advertising platform integrations |
+| `crm` | CRM platform integrations |
+| `telemetry` | Analytics and telemetry |
+| `data-sync` | Data synchronization patterns |
+| `webhook` | Webhook handling patterns |
+| `oauth` | OAuth authentication flows |
+| `batch` | Batch processing patterns |
+
+## See Also
+
+- `../v1/` - V1 legacy examples (for feature reference)
+- `../v2/` - V2 legacy examples (for feature reference)
+- `../../architecture/v3-structure.md` - V3 structure documentation
+- `../../guides/getting-started.md` - Getting started guide

package/dist/ai-context/internal/examples/v3/google-ads/.nvmrc

@@ -0,0 +1 @@
+22

package/dist/ai-context/internal/examples/v3/google-ads/.yarnrc.yml

@@ -0,0 +1,7 @@
+nodeLinker: node-modules
+
+npmScopes:
+  seeka-labs:
+    npmAuthIdent: internal-seeka-developers-apps:2b999f0e3d774bb180f5a5d2759d1358
+    npmAlwaysAuth: true
+    npmRegistryServer: "https://npm.packages.seeka.services"

package/dist/{init-template → ai-context/internal/examples/v3/google-ads}/README.md

@@ -1,4 +1,4 @@
-# @example-org-name/example-app-name
+# @seeka-labs-apps/google-ads
 
 ## Local dev
 
@@ -7,17 +7,17 @@
 
 1. `yarn clean`
 2. Run
-  - server + browser plugin + ui
-    - `clear && yarn start:all`
-  - server + browser plugin
-    - `clear && yarn start:server`
+- server + browser plugin + ui
+  - `clear && yarn start:all`
+- server + browser plugin
+  - `clear && yarn start:server`
 
 ### Updating packages
 
 #### Seeka SDK packages
 ```
 cd repo root
-yarn up "@seeka-labs/*" --mode=update-lockfile && yarn
+yarn up "@seeka-labs/*" --mode=update-lockfile
 ```
 
 #### All packages
@@ -28,7 +28,7 @@ npx npm-check-updates@latest -i --workspaces --target minor && npx npm-check-upd
 
 ## Deploy (GitHub Actions)
 
-This repo deploys to Azure Functions via `.github/workflows/deploy-azurefunc.yml` on pushes to `main` and `staging`.
+This repo deploys to Azure Functions via `.github/workflows/deploy-azure-function.yml` on pushes to `main` and `staging`.
 
 ### Required GitHub secrets (for Azure OIDC)
 
@@ -46,7 +46,7 @@ Repository variable:
 
 GitHub Environment variables (define in environments `prod` and `stag`):
 
-- `AZURE_FUNC_SLOT_NAME`
+- `AZURE_FUNC_SLOT`
 - `VITE_BASE_URL`
 - `VITE_URLS_SEEKA_API_CORE`
 - `VITE_URLS_SEEKA_APP_CORE_ORIGIN`
@@ -54,8 +54,7 @@ GitHub Environment variables (define in environments `prod` and `stag`):
 - `HOSTING_ENV_NAME`
 - `SEEKA_APP_SETTINGS` (JSON object string like `{ "SETTING1": "production" }`)
 
-### GitHub action authenticating to Azure
-- create app registration in entra called devops-github-seeka-developer-apps
-    - for service principal: resource group > IAM > add role assignment > Website contributor
-    - for service principal: subscription > IAM > add role assignment > Reader
-- Assign federated identity to the service principal for GitHub actions at Certificates and Secrets > Federated Identity > Add credential > GitHub actions
+### Optional prefixed config variables/secrets
+
+- Any GitHub Environment variable prefixed with `SEEKA_APP_CFG_` will be pushed to Azure App Settings with the prefix stripped.
+- If you need a small number of these to be secrets, explicitly map them in the workflow (see the commented example in `.github/workflows/deploy-azure-function.yml`).

package/dist/ai-context/internal/examples/v3/google-ads/_ai-summary.md

@@ -0,0 +1,31 @@
+```markdown
+# AI Summary for Seeka App: Google Ads
+
+## Purpose and Functionality
+The Google Ads app is designed to facilitate conversion tracking and offline conversion imports for Google Ads. It receives activity data from Seeka and pushes conversion data to Google Ads using the Google Ads API. This app is particularly useful for businesses looking to integrate their advertising efforts with Google Ads for enhanced conversion tracking.
+
+## Key Implementation Patterns
+- **Monorepo Structure**: The app is structured as a monorepo using Yarn workspaces, with separate components for the browser, UI, and server.
+- **Azure Functions**: The app is deployed as an Azure Function, allowing it to handle webhooks and other asynchronous tasks efficiently.
+- **Webhook Handling**: The app processes various webhook events from Seeka, such as app installations, uninstalls, and activity acceptance, to manage conversions and user interactions.
+- **Concurrency Management**: The app uses the `concurrently` package to run multiple processes in parallel, such as server, browser plugin, and UI development.
+
+## External APIs/Services Integrated
+- **Google Ads API**: The app integrates with the Google Ads API to push conversion data and manage conversion actions.
+- **Azure Storage Queue**: Utilized for managing background jobs and tasks related to conversion tracking.
+
+## Important Data Transformations
+- **Conversion Mapping**: The app transforms Seeka activity data into Google Ads conversion actions using defined mappings (`SeekaActivityToGoogleConversionActionMapping`).
+- **Webhook Payload Processing**: The app parses and validates webhook payloads to ensure data integrity and proper handling of conversion events.
+
+## Notable Code Patterns
+- **TypeScript Interfaces and Types**: Extensive use of TypeScript interfaces and types for defining data structures, such as `GoogleAdsAppBrowserSdkPluginConfig`, `GoogleAdsConversionSettings`, and `SeekaActivityToGoogleConversionActionMapping`.
+- **Validation Logic**: Although currently a placeholder, the app includes a validation function for installation settings, which is intended to block invalid installation requests.
+- **Logging**: The app employs the `winston` logging library to provide detailed logging for debugging and monitoring purposes.
+
+## Deployment and Configuration
+- **GitHub Actions**: Automated deployment to Azure Functions is managed via GitHub Actions, with specific workflows for different environments (production and staging).
+- **Environment Variables**: The app requires several GitHub secrets and environment variables for configuration, including Azure credentials and Seeka API URLs.
+
+This summary provides an overview of the Google Ads app's architecture, integration points, and key functionalities, which can be referenced for further development or integration efforts.
+```

package/dist/ai-context/internal/examples/v3/google-ads/app/.eslintrc.cjs

@@ -0,0 +1,13 @@
+/* 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",
+        "@typescript-eslint/no-empty-object-type": "warn",
+        "@typescript-eslint/no-explicit-any": "warn"
+    }
+};

package/dist/ai-context/internal/examples/v3/google-ads/app/browser/README.md

@@ -0,0 +1 @@
+# `@seeka-labs-apps/google-ads-browser`

package/dist/ai-context/internal/examples/v3/google-ads/app/browser/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@seeka-labs-apps/google-ads-browser",
+  "version": "3.3.2",
+  "description": "Seeka app browser plugin google-ads",
+  "author": "Seeka <platform@seeka.co>",
+  "private": true,
+  "license": "MIT",
+  "files": [
+    "dist/"
+  ],
+  "scripts": {
+    "lint": "eslint --fix src/ --ext .ts",
+    "typecheck": "tsc --noEmit",
+    "clean": "rimraf dist build package",
+    "build": "node ./scripts/esbuild/build-browser-plugin.mjs seeka-browser-plugin GoogleAdsAppConvergeSdkPlugin",
+    "build:dev": "node ./scripts/esbuild/build-browser-plugin.mjs seeka-browser-plugin GoogleAdsAppConvergeSdkPlugin dev",
+    "watch": "node ./scripts/esbuild/build-browser-plugin.mjs seeka-browser-plugin GoogleAdsAppConvergeSdkPlugin dev watch"
+  },
+  "dependencies": {
+    "@seeka-labs-apps/google-ads-lib": "workspace:*",
+    "@seeka-labs/converge": "^1.9.24",
+    "@seeka-labs/converge-lib-gtag": "^1.9.24"
+  },
+  "devDependencies": {
+    "@jgoz/esbuild-plugin-typecheck": "^4",
+    "@types/lodash-es": "^4",
+    "@types/node": "^22",
+    "@typescript-eslint/eslint-plugin": "^8",
+    "@typescript-eslint/parser": "^8",
+    "esbuild": "^0",
+    "eslint": "^9",
+    "eslint-plugin-unused-imports": "^4",
+    "rimraf": "^6",
+    "typescript": "^5",
+    "watch": "^1"
+  }
+}

package/dist/ai-context/internal/examples/v3/google-ads/app/browser/src/browser.ts

@@ -0,0 +1,12 @@
+import { GoogleAdsAppBrowserSdkPluginConfig } from "@seeka-labs-apps/google-ads-lib";
+import { GoogleAdsAppConvergeSdkPlugin } from "./plugin";
+
+declare global {
+  interface Window {
+    GoogleAdsAppConvergeSdkPlugin: (pluginConfig: GoogleAdsAppBrowserSdkPluginConfig) => GoogleAdsAppConvergeSdkPlugin;
+  }
+}
+
+(window as Window).GoogleAdsAppConvergeSdkPlugin = (pluginConfig: GoogleAdsAppBrowserSdkPluginConfig) => {
+  return new GoogleAdsAppConvergeSdkPlugin(pluginConfig);
+}; 

package/dist/ai-context/internal/examples/v3/google-ads/app/browser/src/plugin/index.ts

@@ -0,0 +1,273 @@
+
+import {
+    AnalyticsLibrary,
+    ConvergeSdk,
+    type IActivityCommonProps,
+    type IActivityMetadataProps,
+    type IConvergePlugin,
+    type PersonIdentifiers,
+    TrackingActivityNames
+} from '@seeka-labs/converge';
+
+import type {GoogleAdsAppBrowserSdkPluginConfig} from '@seeka-labs-apps/google-ads-lib';
+
+import {
+    GoogleAnalyticsGtagHelper,
+    type IGoogleAnalyticsPluginConfig,
+    defaultGtagConfig
+} from '@seeka-labs/converge-lib-gtag';
+import {version} from '../../package.json';
+
+export class GoogleAdsAppConvergeSdkPlugin implements IConvergePlugin<GoogleAdsAppBrowserSdkPluginConfig> {
+    constructor(pluginConfig: GoogleAdsAppBrowserSdkPluginConfig) {
+        this.type = "seeka-app-google-ads";
+        this.name = this.type + "-" + pluginConfig.appInstallId;
+        this.version = version;
+        this.sdk = {} as ConvergeSdk;
+        this.config = pluginConfig || {};
+    }
+
+    sdk: ConvergeSdk;
+    gtagHelper: GoogleAnalyticsGtagHelper | null = null;
+    gtagName: string | null = null;
+    isIframeClient: boolean = false;
+
+    privacyConfig = {
+        // TODO
+        requiresIabPurposes: []
+    }
+
+    name: string;
+    type: string;
+    version: string;
+    config: GoogleAdsAppBrowserSdkPluginConfig;
+
+    async beforeInit(): Promise<void> {
+        this.isIframeClient = this.sdk.config.runtime?.client?.type === 'iframe';
+
+        const requiredGoogleTags: string[] = (this.config.installationSettings.mappings || []).map(e => e.googleConversionAction?.conversionId || '').filter(Boolean);
+        if (requiredGoogleTags.length === 0) {
+            this.sdk.debug.verbose('Google Ads - No Google tags required for Google Ads plugin');
+            return;
+        }
+
+        const existingGoogleTags = (this.sdk.config.tracking.analytics?.libraries?.googleAnalytics?.googleTags || []).map(e => e.tagId).filter(Boolean) as string[];
+
+        // Check if required google tags are already present
+        const missingGoogleTags = requiredGoogleTags.filter(e => existingGoogleTags.indexOf(e) === -1);
+        if (missingGoogleTags.length > 0) {
+            this.sdk.debug.verbose(`Google Ads - Adding Google tags for Google Ads plugin: ${missingGoogleTags.join(', ')}`);
+            if (!this.sdk.config.tracking) this.sdk.config.tracking = {};
+            if (!this.sdk.config.tracking.analytics) this.sdk.config.tracking.analytics = {};
+            if (!this.sdk.config.tracking.analytics.libraries) this.sdk.config.tracking.analytics.libraries = {};
+            if (!this.sdk.config.tracking.analytics.libraries.googleAnalytics) this.sdk.config.tracking.analytics.libraries.googleAnalytics = {};
+            if (!this.sdk.config.tracking.analytics.libraries.googleAnalytics.googleTags) this.sdk.config.tracking.analytics.libraries.googleAnalytics.googleTags = [];
+
+            this.sdk.config.tracking.analytics.libraries.googleAnalytics.googleTags = [...this.sdk.config.tracking.analytics.libraries.googleAnalytics.googleTags, ...missingGoogleTags.map(e => ({tagId: e}))];
+
+            await this.checkConfigureGtags();
+        }
+    }
+
+    private async checkConfigureGtags(): Promise<void> {
+        if (!this.sdk.config.plugins || this.sdk.config.plugins.length === 0) {
+            this.sdk.debug.warn('Google Ads - No plugins detected');
+            return;
+        }
+
+        const hasGoogleAnalytics4Plugin = this.sdk.config.plugins.some(e => e.type === 'converge-plugin-google-analytics-4');
+        if (!hasGoogleAnalytics4Plugin) {
+            this.sdk.debug.verbose('Google Ads - No Google Analytics 4 plugin detected, configuring GTAGs');
+            await this.configureGtags();
+        } else {
+            this.sdk.debug.verbose('Google Ads - Google Analytics 4 plugin detected, not configuring GTAGs');
+        }
+    }
+
+    private async configureGtags() {
+        const tags = this.sdk.config.tracking?.analytics?.libraries?.googleAnalytics?.googleTags || [];
+        if (tags.length === 0) {
+            this.sdk.debug.warn('Google Ads - No Google tags configured for Google Ads plugin');
+            return;
+        }
+
+        // Each Seeka instance install to have a unique gtag name and data layer name
+        const uniqueId = `${this.sdk.config.scopeKey}_${this.sdk.util.text.alphaNumericOnly(this.config.appInstallId)}`;
+        this.gtagName = `gtagSeekaGa4_${uniqueId}`;
+        const dataLayerName = `dataLayerSeekaGa4_${uniqueId}`;
+
+        this.gtagHelper = new GoogleAnalyticsGtagHelper(this.sdk, {
+            // ...params.config,
+            measurementIds: [],
+            isGoogleDebugMode: this.sdk.debug.isDebugEnabled,
+            // enableAutomaticLastTouchAttribution: this.config?.enableAutomaticLastTouchAttribution,
+            additionalTags: tags,
+            gtagName: this.gtagName,
+            dataLayerName,
+            isIframeClient: this.isIframeClient,
+            gtagConfig: {
+                ...defaultGtagConfig,
+                cookie_prefix: "_ga_seeka",
+            }
+        } as IGoogleAnalyticsPluginConfig);
+        this.gtagHelper.initialize();
+    }
+
+    async activity(name: TrackingActivityNames, props?: IActivityCommonProps, metadata?: IActivityMetadataProps): Promise<void> {
+        this.sdk.debug.log(`Google Ads - Listened to activity ${name} with props`, {props, metadata});
+
+        const conversions = (this.config?.installationSettings.mappings || []).filter(Boolean).filter(e => e.active && e.googleConversionAction && (e.googleConversionAction.type === 'WEBPAGE' || e.googleConversionAction.type === 'WEBPAGE_CODELESS'));
+        if (conversions.length === 0) return;
+
+        for (const conversion of conversions) {
+            const matchResult = this.sdk.activity.isActivityMatchedToFilter(conversion.seekaActivityMatch, this.type, name, props, metadata)
+            const shouldTrackConversion = matchResult.isMatch;
+            const conversionValue = {
+                currencyCode: props?.currencyCode || this.sdk.config?.tracking?.analytics?.autoCollection?.defaultActivityCurrencyAmount?.currencyCode || this.sdk.config.tracking?.defaults?.currencyCode || null,
+                value: props?.unitPrice || props?.totalPrice || this.sdk.config?.tracking?.analytics?.autoCollection?.defaultActivityCurrencyAmount?.amount || null
+            }
+            if (!shouldTrackConversion) {
+                this.sdk.debug.verbose(`Google Ads - Activity ${name} does not match conversion mapping`, {
+                    name,
+                    props,
+                    conversion,
+                    matchResult
+                });
+            }
+            // else {
+            //   conversionValue = getActivityValue({
+            //     activityName: name,
+            //     ...props,
+            //     ...metadata
+            //   }, true);
+            //   if (!conversionValue) {
+            //     conversionValue = {
+            //       currencyCode: this.sdk.config?.tracking?.analytics?.autoCollection?.defaultActivityCurrencyAmount?.currencyCode || this.sdk.config.tracking?.defaults?.currencyCode || null,
+            //       value: this.sdk.config?.tracking?.analytics?.autoCollection?.defaultActivityCurrencyAmount?.amount || null
+            //     }
+            //   }
+            // if (!conversionValue.value) {
+            //   // shouldTrackConversion = false;
+            //   this.sdk.debug.log(`Google Ads - Activity ${name} does not contain a value ${name}`, { name, props, conversion });
+            // }
+            // }
+
+            if (shouldTrackConversion) {
+                if (!conversionValue.value) {
+                    // shouldTrackConversion = false;
+                    this.sdk.debug.log(`Google Ads - Activity ${name} does not contain a value ${name}`, {
+                        name,
+                        props,
+                        conversion
+                    });
+                }
+                this.sdk.debug.verbose(`Google Ads - Tracking conversion for activity ${name} with conversion id ${conversion.googleConversionAction.conversionId} and label ${conversion.googleConversionAction.conversionLabel} and value ${conversionValue}`);
+
+                const payload = {
+                    'send_to': `${conversion.googleConversionAction.conversionId}/${conversion.googleConversionAction.conversionLabel}`,
+                    'value': conversionValue?.value,
+                    'currency': conversionValue?.currencyCode,
+                    'transaction_id': props?.orderIdentifier || props?.orderNumber || props?.activityIdentifier,
+                };
+
+                const operationSource = "Google Ads - Conversion track";
+                // const logProps = { props: payload, logMetadata: { stream: true, destination: { activityName: 'conversion', platform: AnalyticsLibrary.GoogleAds, identifier: conversion.conversionId } } };
+                const logProps = {
+                    props: payload,
+                    logMetadata: {
+                        stream: true,
+                        destination: {
+                            activityName: 'conversion',
+                            platform: AnalyticsLibrary.GoogleAnalytics,
+                            identifier: conversion.googleConversionAction.conversionId
+                        }
+                    }
+                };
+                if (this.sdk.debug.isOperationAllowed('conversion', operationSource, logProps)) {
+                    // (window[gtagName] as any)("event", event, payload);
+
+                    const called = this.callGtag('event', 'conversion', payload)
+                    if (!called) {
+                        this.sdk.debug.warn('Google Ads - Google tag not found, not firing Google Ads conversion', {
+                            conversionId: conversion.googleConversionAction.conversionId,
+                            conversionLabel: conversion.googleConversionAction.conversionLabel
+                        });
+                    }
+
+                    this.sdk.debug.log(`${operationSource} ` + 'conversion', logProps);
+                }
+            }
+        }
+    }
+
+    private callGtag(param1: string, param2: string, payload: any): boolean {
+        if (!this.gtagHelper) {
+            return this.callGtagViaPlugin(param1, param2, payload);
+        } else {
+            if (!this.gtagName) {
+                this.sdk.debug.warn('Google Ads - Google tag name not found');
+                return false;
+            }
+            const gtagWin = (window as any)[this.gtagName];
+            if (!gtagWin) {
+                this.sdk.debug.warn('Google Ads - Google tag not found');
+                return false;
+            }
+
+            gtagWin(param1, param2, payload);
+            this.sdk.debug.verbose(`Google Ads - Called Google tag ${this.gtagName} with payload`, {payload});
+            return true;
+        }
+    }
+
+    private callGtagViaPlugin(param1: string, param2: string, payload: any): boolean {
+        const ga4Plugins = (this.sdk.config.plugins || []).filter(e => e.type === 'converge-plugin-google-analytics-4');
+        if (!ga4Plugins || ga4Plugins.length === 0) return false;
+
+        let called = false;
+        ga4Plugins.forEach(ga4Plugin => {
+            const gtagName = (ga4Plugin as any).analyticsLibPlugin?.config?.gtagName;
+            if (!gtagName) return;
+
+            const gtagWin = (window as any)[gtagName];
+            if (!gtagWin) return;
+
+            gtagWin(param1, param2, payload);
+            this.sdk.debug.verbose(`Google Ads - Called plugin Google tag ${gtagName} with payload`, {payload});
+
+            called = true;
+        })
+
+        return called;
+    }
+
+    async collectIdentifiers(): Promise<PersonIdentifiers | undefined> {
+        const data = {
+            google: {
+                gclid: [] as string[]
+            }
+        };
+
+        // googleAnalytics click - glclid query string
+        try {
+            const gclid = this.sdk.util.url.getParamFromQueryString('gclid', this.sdk.dataLayer.window.location()?.href);
+            if (gclid) {
+                data.google.gclid.push(gclid as string);
+            }
+        } catch (err) {
+            this.sdk.debug.warn("Google Ads - Failed to set gclid", err);
+        }
+
+        this.sdk.debug.verbose('Google Ads - collected identifiers', data);
+
+        return data;
+    }
+
+    async init(_params: any): Promise<void> {
+        // checkSdkAndPluginVersion(dependencies['@seeka-labs/converge'], this.sdk, this.name)
+    }
+
+    isLoaded(): boolean {
+        return true;
+    }
+}

package/dist/ai-context/internal/examples/v3/google-ads/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",
+  ]
+}