@seeka-labs/cli-apps 3.7.0 → 3.8.2

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

@@ -0,0 +1,44 @@
+{
+  "name": "@seeka-labs-apps/google-ads-lib",
+  "version": "3.3.2",
+  "description": "Seeka app library for google-ads",
+  "author": "Seeka <platform@seeka.co>",
+  "license": "MIT",
+  "private": true,
+  "files": [
+    "dist/"
+  ],
+  "types": "./dist/lib/types/index.d.ts",
+  "source": "src/index.ts",
+  "main": "./dist/lib/google-ads-lib.module.js",
+  "module": "./dist/lib/google-ads-lib.module.js",
+  "devDependencies": {
+    "@seeka-labs/sdk-apps-core": "^3.6.8",
+    "@seeka-labs/sdk-apps-server": "^3.6.8",
+    "@types/lodash-es": "^4",
+    "@types/node": "^22",
+    "axios": "^1",
+    "esbuild": "^0",
+    "lodash-es": "^4",
+    "memory-cache": "^0",
+    "openid-client": "^6",
+    "rimraf": "^6",
+    "typescript": "^5",
+    "undici": "^7",
+    "winston": "^3",
+    "zod": "^4"
+  },
+  "peerDependencies": {
+    "@seeka-labs/sdk-apps-core": "^3",
+    "@seeka-labs/sdk-apps-server": "^3",
+    "lodash-es": "^4",
+    "undici": "^7",
+    "zod": "^4"
+  },
+  "scripts": {
+    "clean": "rimraf build package dist",
+    "typecheck": "tsc --noEmit",
+    "build": "yarn esbuild src/index.ts --outfile=dist/lib/google-ads-lib.module.js --bundle --analyze --platform=node --format=esm --packages=external --minify && yarn tsc --emitDeclarationOnly",
+    "dev": "yarn esbuild src/index.ts --outfile=dist/lib/google-ads-lib.module.js --bundle --analyze --platform=node --format=esm --packages=external --sourcemap && yarn tsc --emitDeclarationOnly"
+  }
+}

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

@@ -0,0 +1,5 @@
+
+export * from './models';
+export * from './validation';
+export * from './utils';
+

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

@@ -0,0 +1,113 @@
+import { SeekaAppUiClientInitConfig} from '@seeka-labs/sdk-apps-core'
+import {SeekaAppInstallContext} from "@seeka-labs/sdk-apps-core";
+import type {ActivityPipelineActivityFilter, ConvergeTrackingConfiguration} from '@seeka-labs/sdk-apps-server';
+
+export interface GoogleAdsAppBrowserSdkPluginConfig {
+    appId: string
+    appInstallId: string
+    appUrl: string
+    installationSettings: {
+        mappings?: SeekaActivityToGoogleConversionActionMapping[]
+    }
+}
+
+export type GoogleAdsBrowserConversionItem = {
+    activityNames: string[];
+    conversionId: string;
+    conversionLabel: string;
+}
+
+export interface LinkedGoogleAdsUser {
+    email?: string;
+}
+
+export type GoogleAdsCustomerInfo = {
+    customerId: string;
+    customerName: string;
+    isManager: boolean;
+    children?: GoogleAdsCustomerInfo[]
+}
+
+export type GoogleAdsConversionSettings = {
+    // browserConversions?: GoogleAdsBrowserConversionItem[];
+    serverConversions: SeekaActivityToGoogleConversionActionMapping[];
+}
+
+export interface DetailedGoogleAdsCustomerInfo extends GoogleAdsCustomerInfo {
+    customerDataTermsAccepted: boolean;
+    enhancedConversionsEnabled: boolean;
+    enhancedConversionsForLeadsEnabled: boolean;
+    googleAdsConversionCustomer: string;
+    // conversionTrackingStatus: google.resources.ConversionTrackingSetting['conversion_tracking_status'];
+    conversionTrackingId: number | null;
+    crossAccountConversionTrackingId: number | null;
+}
+
+export interface GoogleAdsConversionActionTagSnippet {
+    /** TagSnippet type */
+    type?: string
+
+    /** TagSnippet page_format */
+    pageFormat?: string
+
+    /** TagSnippet global_site_tag */
+    globalSiteTag?: string
+
+    /** TagSnippet event_snippet */
+    eventSnippet?: string
+
+    conversionId?: string
+
+    conversionLabel?: string
+}
+
+export type GoogleAdsConversionActionInfo = {
+    /** e.g. "customers/1234567890/conversionActions/111222333" */
+    resourceName: string;
+    /** numeric ID of the conversion action */
+    id: number;
+    /** the name you see in the UI */
+    name: string;
+    /** e.g. ENABLED, PAUSED, REMOVED */
+    status: string;
+    /** e.g. WEBPAGE, APP, PHONE_CALL */
+    type: string;
+    /** e.g. DEFAULT, PURCHASE, SIGNUP */
+    category: string;
+
+    conversionId?: string
+
+    conversionLabel?: string
+};
+
+export type SeekaActivityToGoogleConversionActionMapping = {
+    seekaActivityMatch: ActivityPipelineActivityFilter
+    googleConversionAction: GoogleAdsConversionActionInfo
+    active: boolean
+    id: string
+}
+
+export type GoogleAdsAppInstallSettings = {
+    googleAdsCustomerId?: string
+    googleAdsRootCustomerId?: string
+    googleAdsAvailableCustomers?: GoogleAdsCustomerInfo[]
+    googleAdsAccountName?: string
+    googleAccessToken?: string
+    trackingSettings?: ConvergeTrackingConfiguration
+    conversions?: GoogleAdsConversionSettings;
+    linkedGoogleAdsUser?: LinkedGoogleAdsUser
+}
+
+export type GoogleAdsAppUiClientInitState = {
+    googleAdsAvailableCustomers?: GoogleAdsCustomerInfo[];
+    googleAdsCustomerId?: string;
+    googleAdsRootCustomerId?: string;
+    conversions?: GoogleAdsConversionSettings,
+    linkedGoogleAdsUser?: LinkedGoogleAdsUser
+}
+
+export type GoogleAdsAppInstallState = GoogleAdsAppInstallSettings
+
+export type GoogleAdsAppInstallContext = SeekaAppInstallContext<GoogleAdsAppInstallState>
+
+export type GoogleAdsAppUiClientInitConfig = SeekaAppUiClientInitConfig<GoogleAdsAppUiClientInitState>

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

@@ -0,0 +1,66 @@
+import { createHash } from 'node:crypto';
+
+/**
+ * Normalize a generic value (trim + lowercase).
+ */
+export function toNormalizedValue(value: string): string {
+    return value.trim().toLowerCase();
+}
+
+/**
+ * SHA-256 hash -> lowercase hex string.
+ */
+export function toSha256String(value: string): string {
+    return createHash('sha256').update(value, 'utf8').digest('hex');
+}
+
+/**
+ * Normalizes and hashes a string value.
+ * Mirrors: ToSha256String(digest, ToNormalizedValue(value))
+ */
+export function googleAdsNormalizeAndHash(value: string): string {
+    return toSha256String(toNormalizedValue(value));
+}
+
+/**
+ * Normalizes the email and hashes it.
+ * For gmail.com / googlemail.com, remove '.' in the local-part (before the @).
+ * (Matches the behavior shown in your C# snippet.)
+ */
+export function googleAdsNormalizeAndHashEmailAddress(emailAddress: string): string {
+    let normalizedEmail = emailAddress.toLowerCase();
+
+    const atIndex = normalizedEmail.indexOf('@');
+    if (atIndex > 0 && atIndex < normalizedEmail.length - 1) {
+        const local = normalizedEmail.slice(0, atIndex);
+        const domain = normalizedEmail.slice(atIndex + 1);
+
+        if (domain === 'gmail.com' || domain === 'googlemail.com') {
+            const localNoDots = local.replace(/\./g, '');
+            normalizedEmail = `${localNoDots}@${domain}`;
+        }
+    }
+
+    return googleAdsNormalizeAndHash(normalizedEmail);
+}
+
+
+export function toGoogleAdsDateTime(date: Date): string {
+    const pad = (n: number) => n.toString().padStart(2, '0');
+
+    const year = date.getFullYear();
+    const month = pad(date.getMonth() + 1);
+    const day = pad(date.getDate());
+
+    const hours = pad(date.getHours());
+    const minutes = pad(date.getMinutes());
+    const seconds = pad(date.getSeconds());
+
+    const offsetMinutes = date.getTimezoneOffset();
+    const absOffsetMinutes = Math.abs(offsetMinutes);
+    const offsetHours = pad(Math.floor(absOffsetMinutes / 60));
+    const offsetMins = pad(absOffsetMinutes % 60);
+    const offsetSign = offsetMinutes > 0 ? '-' : '+';
+
+    return `${year}-${month}-${day} ${hours}:${minutes}:${seconds}${offsetSign}${offsetHours}:${offsetMins}`;
+}

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

@@ -0,0 +1,10 @@
+import type {Logger} from "winston";
+import {GoogleAdsAppInstallSettings} from "../models";
+
+// TODO: Use Zod
+export const validateInstallationSettings = async (installSettings: GoogleAdsAppInstallSettings, logger: Logger): Promise<string | null> => {
+    // Returning an error message string here will block the installation request or settings update request by the user installing the app
+
+    if(!installSettings) return null;
+    return null;
+}

package/dist/ai-context/internal/examples/v3/google-ads/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/v3/google-ads/app/server/.eslintrc.cjs

@@ -0,0 +1,4 @@
+/* eslint-env node */
+module.exports = {
+    extends: ['../.eslintrc.cjs']
+};

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

@@ -0,0 +1,105 @@
+# 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 example 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://google-ads.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: google-ads
+    - 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. If your app receives calls directly from the browser (eg. your browser app plugin) then CORS needs to be enabled for all origins from within the settings of the Function app in Azure portal.
+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/v3/google-ads/app/server/host.json

@@ -0,0 +1,31 @@
+{
+  "version": "2.0",
+  "logging": {
+    "applicationInsights": {
+      "samplingSettings": {
+        "isEnabled": true,
+        "excludedTypes": "Request"
+      }
+    }
+  },
+  "extensions": {
+    "http": {
+      "routePrefix": ""
+    },
+    "queues": {
+      "batchSize": 32,
+      "newBatchThreshold": 8,
+      "maxDequeueCount": 1,
+      "visibilityTimeout": "00:00:30"
+    }
+  },
+  "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/v3/google-ads/app/server/package.json

@@ -0,0 +1,72 @@
+{
+  "name": "@seeka-labs-apps/google-ads-server",
+  "version": "3.3.2",
+  "description": "Seeka Azure Serverless function app google-ads",
+  "author": "Seeka <platform@seeka.co>",
+  "license": "MIT",
+  "main": "dist/src/functions/*.js",
+  "private": true,
+  "engines": {
+    "node": ">=22"
+  },
+  "scripts": {
+    "lint": "eslint",
+    "typecheck": "tsc --noEmit",
+    "build": "node ./scripts/build.mjs",
+    "watch": "node ./scripts/build.mjs --watch",
+    "clean": "rimraf dist",
+    "prestart": "echo 'pre starting' && yarn build",
+    "dev": "func start --port 7072",
+    "tunnel": "ngrok http 7072 --hostname=seeka-app-google-ads-localdev.au.ngrok.io --region au --log=stdout --log-format=term",
+    "deploy": "func azure functionapp publish google-ads --no-build --javascript",
+    "dev:queue:create": "node scripts/dev-queue-setup.js google-ads-conv-action-track-queue && node scripts/dev-queue-setup.js google-ads-conv-action-track-queue-poison"
+  },
+  "dependencies": {
+    "@azure/functions": "^4",
+    "@azure/storage-queue": "^12",
+    "@opentelemetry/api": "^1",
+    "@opentelemetry/exporter-logs-otlp-proto": "^0",
+    "@opentelemetry/exporter-trace-otlp-proto": "^0",
+    "@opentelemetry/instrumentation-grpc": "^0",
+    "@opentelemetry/instrumentation-http": "^0",
+    "@opentelemetry/instrumentation-ioredis": "^0",
+    "@opentelemetry/instrumentation-net": "^0",
+    "@opentelemetry/instrumentation-undici": "^0",
+    "@opentelemetry/instrumentation-winston": "^0",
+    "@opentelemetry/sdk-node": "^0",
+    "@opentelemetry/sdk-trace-node": "^2",
+    "@opentelemetry/winston-transport": "^0",
+    "@redis/client": "^5",
+    "@redis/json": "^5",
+    "@seeka-labs-apps/google-ads-lib": "workspace:^",
+    "@seeka-labs/sdk-apps-core": "^3.6.8",
+    "@seeka-labs/sdk-apps-server": "^3.6.8",
+    "@seeka-labs/sdk-apps-server-host": "^3.6.8",
+    "@seeka-labs/sdk-apps-server-telemetry-core": "^3.6.8",
+    "@seeka-labs/sdk-apps-server-telemetry-logging": "^3.6.8",
+    "axios": "^1",
+    "google-ads-api": "^21.0.1",
+    "google-auth-library": "^10.4.2",
+    "jsonwebtoken": "^9",
+    "jwt-decode": "^4",
+    "lodash-es": "^4",
+    "memory-cache": "^0",
+    "openid-client": "^6",
+    "redis": "^5",
+    "undici": "^7",
+    "winston": "^3",
+    "yup": "^1"
+  },
+  "devDependencies": {
+    "@types/jsonwebtoken": "^9",
+    "@types/lodash-es": "^4",
+    "@types/node": "^22",
+    "@typescript-eslint/eslint-plugin": "^8",
+    "@typescript-eslint/parser": "^8",
+    "esbuild": "^0",
+    "eslint": "^9",
+    "glob": "^11",
+    "rimraf": "^6",
+    "typescript": "^5"
+  }
+}

package/dist/ai-context/internal/examples/v3/google-ads/app/server/src/app/api/router.ts

@@ -0,0 +1,26 @@
+import { GoogleAdsAppInstallContext } from "@seeka-labs-apps/google-ads-lib";
+import { SeekaAppInstallContext } from "@seeka-labs/sdk-apps-core";
+import { Logger } from "winston";
+import { AppUiHttpRequestResponse, HttpMethod } from "@seeka-labs/sdk-apps-server-host";
+import {HttpRequest, InvocationContext} from "@azure/functions";
+import {setGoogleCustomerId} from "./routes/setGoogleCustomerId";
+import {getGoogleCustomerInfo} from "./routes/getGoogleCustomerInfo";
+import {getAccessibleCustomerList} from "./routes/getAccessibleCustomers";
+import {disconnectGoogle} from "./routes/disconnectGoogle";
+import {getGoogleAuthInfo} from "./routes/getGoogleAuthInfo";
+import {getGoogleConversionActions} from "./routes/getGoogleConversionActions";
+import {setConversionMappings} from "./routes/setConversionMappings";
+import {setTrackingSettings} from "./routes/setTrackingSettings";
+
+export const apiRouteHandler = async (req: HttpRequest, context: InvocationContext, requestedPath: string, requestedMethod: HttpMethod, installation: GoogleAdsAppInstallContext, logger: Logger ): Promise<AppUiHttpRequestResponse | null> => {
+    if (requestedPath === '/api/google/customer' && requestedMethod === 'POST') return await setGoogleCustomerId(installation, req, context, logger);
+    if (requestedPath === '/api/google/customer' && requestedMethod === 'GET') return await getGoogleCustomerInfo(installation, req, context, logger);
+    if (requestedPath === '/api/google/customers' && requestedMethod === 'GET') return await getAccessibleCustomerList(installation, req, context, logger);
+    if (requestedPath === '/api/google/auth' && requestedMethod === 'DELETE') return await disconnectGoogle(installation, req, context, logger);
+    if (requestedPath === '/api/google/auth' && requestedMethod === 'GET') return await getGoogleAuthInfo(installation, req, context, logger);
+    if (requestedPath === '/api/google/customer/conversions/actions' && requestedMethod === 'GET') return await getGoogleConversionActions(installation, req, context, logger);
+    if (requestedPath === '/api/settings/conversions/mappings' && requestedMethod === 'POST') return await setConversionMappings(installation, req, context, logger);
+    if (requestedPath === '/api/settings/tracking' && requestedMethod === 'POST') return await setTrackingSettings(installation, req, context, logger);
+
+    return null;
+}

package/dist/ai-context/internal/examples/v3/google-ads/app/server/src/app/api/routes/disconnectGoogle.ts

@@ -0,0 +1,21 @@
+import { HttpRequest, HttpResponseInit, InvocationContext } from "@azure/functions";
+import { Logger } from "winston";
+import { GoogleAdsAppInstallContext, GoogleAdsAppInstallSettings } from "@seeka-labs-apps/google-ads-lib";
+import {AppUiHttpRequestResponse, createOrUpdateInstallation} from "@seeka-labs/sdk-apps-server-host";
+
+export const disconnectGoogle = async (installation: GoogleAdsAppInstallContext, req: HttpRequest, context: InvocationContext, logger: Logger): Promise<AppUiHttpRequestResponse> => {
+    installation.installationState = {
+        ...installation.installationState,
+        googleAdsCustomerId: null,
+        googleAdsRootCustomerId: null,
+        linkedGoogleAdsUser: null,
+        googleAdsAvailableCustomers: [],
+        googleAdsAccountName: null,
+        googleAccessToken: null
+    };
+    await createOrUpdateInstallation(installation, logger);
+
+    return {
+        status: 200
+    };
+}

package/dist/ai-context/internal/examples/v3/google-ads/app/server/src/app/api/routes/getAccessibleCustomers.ts

@@ -0,0 +1,16 @@
+import { HttpRequest, InvocationContext } from "@azure/functions";
+import { Logger } from "winston";
+import {AppUiHttpRequestResponse} from "@seeka-labs/sdk-apps-server-host";
+import {GoogleAdsAppInstallContext} from "@seeka-labs-apps/google-ads-lib";
+import {getAccessibleCustomers} from "../../services/google/customers";
+
+export const getAccessibleCustomerList = async (installation: GoogleAdsAppInstallContext, req: HttpRequest, context: InvocationContext, logger: Logger): Promise<AppUiHttpRequestResponse> => {
+    const customerInfo = await getAccessibleCustomers(true, installation, logger)
+
+    return {
+        status: 200,
+        jsonBody: {
+            customers: customerInfo
+        }
+    };
+}

package/dist/ai-context/internal/examples/v3/google-ads/app/server/src/app/api/routes/getGoogleAuthInfo.ts

@@ -0,0 +1,23 @@
+import { HttpRequest, HttpResponseInit, InvocationContext } from "@azure/functions";
+import { Logger } from "winston";
+import {AppUiHttpRequestResponse} from "@seeka-labs/sdk-apps-server-host";
+import {GoogleAdsAppInstallContext} from "@seeka-labs-apps/google-ads-lib";
+import {listConversionActions} from "../../services/google/conversions/actions";
+
+export const getGoogleAuthInfo = async (installation: GoogleAdsAppInstallContext, req: HttpRequest, context: InvocationContext, logger: Logger): Promise<AppUiHttpRequestResponse> => {
+    const linkedUser = installation.installationState.linkedGoogleAdsUser;
+    let auth: boolean | null = null
+    if (linkedUser && installation.installationState?.googleAdsCustomerId) {
+        // Test connection
+        const actions = await listConversionActions(installation.installationState?.googleAdsCustomerId, installation.installationState?.googleAdsRootCustomerId, installation, logger)
+        auth = actions !== null
+    }
+
+    return {
+        status: 200,
+        jsonBody: {
+            linkedGoogleAdsUser: installation.installationState.linkedGoogleAdsUser,
+            auth
+        }
+    };
+}

package/dist/ai-context/internal/examples/v3/google-ads/app/server/src/app/api/routes/getGoogleConversionActions.ts

@@ -0,0 +1,32 @@
+import { HttpRequest, InvocationContext } from "@azure/functions";
+import { Logger } from "winston";
+import {AppUiHttpRequestResponse} from "@seeka-labs/sdk-apps-server-host";
+import {GoogleAdsAppInstallContext} from "@seeka-labs-apps/google-ads-lib";
+import {listConversionActions} from "../../services/google/conversions/actions";
+
+export const getGoogleConversionActions = async (installation: GoogleAdsAppInstallContext, req: HttpRequest, context: InvocationContext, logger: Logger): Promise<AppUiHttpRequestResponse> => {
+    // Validate
+    const reqUrl = new URL(req.url);
+    const customerId = reqUrl.searchParams.get('customerId');
+    if (!customerId) {
+        return {
+            status: 400,
+            jsonBody: { error: 'customerId is required' }
+        };
+    }
+    const exists = installation.installationState.googleAdsAvailableCustomers?.map(e => e.customerId)?.includes(customerId) || [];
+    if (!exists) {
+        return {
+            status: 400,
+            jsonBody: { error: 'customerId is not available' }
+        };
+    }
+
+    const rootCustomerId = reqUrl.searchParams.get('rootCustomerId');
+    const actions = await listConversionActions(customerId, rootCustomerId, installation, logger)
+
+    return {
+        status: 200,
+        jsonBody: actions || []
+    };
+}

package/dist/ai-context/internal/examples/v3/google-ads/app/server/src/app/api/routes/getGoogleCustomerInfo.ts

@@ -0,0 +1,32 @@
+import { HttpRequest, InvocationContext } from "@azure/functions";
+import { Logger } from "winston";
+import {AppUiHttpRequestResponse} from "@seeka-labs/sdk-apps-server-host";
+import {GoogleAdsAppInstallContext} from "@seeka-labs-apps/google-ads-lib";
+import {getGoogleAdsCustomerInfo} from "../../services/google/customers";
+
+export const getGoogleCustomerInfo = async (installation: GoogleAdsAppInstallContext, req: HttpRequest, context: InvocationContext, logger: Logger): Promise<AppUiHttpRequestResponse> => {
+    // Validate
+    const reqUrl = new URL(req.url);
+    const customerId = reqUrl.searchParams.get('customerId');
+    if (!customerId) {
+        return {
+            status: 400,
+            jsonBody: { error: 'customerId is required' }
+        };
+    }
+    const rootCustomerId = reqUrl.searchParams.get('rootCustomerId');
+    const exists = installation.installationState.googleAdsAvailableCustomers?.map(e => e.customerId)?.includes(customerId) || [];
+    if (!exists) {
+        return {
+            status: 400,
+            jsonBody: { error: 'customerId is not available' }
+        };
+    }
+
+    const customerInfo = await getGoogleAdsCustomerInfo(customerId, rootCustomerId, installation, logger)
+
+    return {
+        status: 200,
+        jsonBody: customerInfo
+    };
+}