@seeka-labs/cli-apps 3.7.0 → 3.8.2

package/dist/ai-context/internal/examples/v2/yeastar/app/server/src/lib/api/auth.ts

@@ -0,0 +1,91 @@
+import { HttpRequest } from "@azure/functions";
+import { appAccessTokenHeaderName, appAccessTokenQueryParamName, coreApiAccessTokenHeaderName, coreApiAccessTokenQueryParamName, getAppAccessTokenCookieName, getCoreApiAccessTokenCookieName } from "@seeka-labs/sdk-apps-core";
+import jwt from 'jsonwebtoken';
+import { Logger } from "winston";
+import { startServices } from '../services';
+import { SeekaAppInstallState, tryGetInstallation } from "../state/seeka/installations";
+
+
+export const getAccessTokenAndCheck = async (req: HttpRequest, logger: Logger): Promise<AppApiAuthInfo | undefined> => {
+    const reqUrl = new URL(req.url);
+
+    // Get access token from cookie
+    const cookies = req.headers.get('Cookie');
+    // logger.info('Cookie', cookies);
+    let accessToken: string = reqUrl.searchParams.get(appAccessTokenQueryParamName) || '';
+    if (!accessToken && req.headers.get(appAccessTokenHeaderName)) {
+        accessToken = req.headers.get(appAccessTokenHeaderName)?.split('Bearer ')[1];
+    }
+    if (!accessToken && cookies) {
+        const cookie = cookies.split(';').find(c => c.trim().startsWith(getAppAccessTokenCookieName(process.env.SEEKA_APP_ID)));
+        if (cookie) {
+            accessToken = cookie.split('=')[1];
+        }
+    }
+
+    let coreApiAccessToken: string = reqUrl.searchParams.get(coreApiAccessTokenQueryParamName) || '';
+    if (!coreApiAccessToken && req.headers.get(coreApiAccessTokenHeaderName)) {
+        coreApiAccessToken = req.headers.get(coreApiAccessTokenHeaderName)?.split('Bearer ')[1];
+    }
+    if (!coreApiAccessToken && cookies) {
+        const cookie = cookies.split(';').find(c => c.trim().startsWith(getCoreApiAccessTokenCookieName(process.env.SEEKA_APP_ID)));
+        if (cookie) {
+            coreApiAccessToken = cookie.split('=')[1];
+        }
+    }
+
+    // Validate access token
+    return await checkAuth(accessToken, coreApiAccessToken, true, logger);
+}
+
+export const checkAuth = async (appAccessToken: string, coreApiAccessToken: string, startAppServices: boolean, logger: Logger): Promise<AppApiAuthInfo | undefined> => {
+    let seekaAppId: string;
+    let seekaAppInstallId;
+    let expiresAt: number;
+
+    // Validate access token
+    if (appAccessToken) {
+        try {
+            const decoded = jwt.verify(appAccessToken, process.env['SEEKA_APP_SECRET'] as string) as jwt.JwtPayload;
+            logger.info('Decoded token', { decoded });
+            if (!decoded.appId || decoded.appId.replace(/-/g, '') !== process.env['SEEKA_APP_ID'].replace(/-/g, '') as string) {
+                logger.error('Invalid token - app id does not match', { decoded, appIdToken: decoded.appId, appIdEnv: process.env['SEEKA_APP_ID'] });
+                return undefined;
+            }
+            else {
+                seekaAppId = decoded.appId;
+            }
+            if (!decoded.appInstallId) {
+                logger.error('Invalid token - no appInstallId', { decoded });
+                return undefined;
+            }
+            else {
+                seekaAppInstallId = decoded.appInstallId;
+            }
+
+            expiresAt = decoded.exp as number;
+        }
+        catch (err) {
+            logger.error('Failed to validate token', { err });
+            return undefined;
+        }
+    }
+    else {
+        logger.error('No access token present');
+        return undefined;
+    }
+
+    // Check if the webhook is for an app we have installed    
+    if (startAppServices) {
+        await startServices(logger);
+    }
+    const installation = await tryGetInstallation(seekaAppInstallId, false, logger);
+    if (installation == null) {
+        logger.warn('UI call cannot be processed as the installation ID is not known by this app', { seekaAppInstallId });
+        return undefined;
+    }
+
+    return { appAccessToken, coreApiAccessToken, seekaAppId, seekaAppInstallId, expiresAt, installation };
+}
+
+export interface AppApiAuthInfo { appAccessToken: string, coreApiAccessToken: string, seekaAppId: string, seekaAppInstallId: string, expiresAt: number, installation: SeekaAppInstallState }

package/dist/ai-context/internal/examples/v2/yeastar/app/server/src/lib/api/routes/setTrackingSettings.ts

@@ -0,0 +1,26 @@
+import { HttpRequest, HttpResponseInit, InvocationContext } from "@azure/functions";
+import { YeastarTrackingSettings } from "@seeka-app-yeastar/lib";
+import { Logger } from "winston";
+import { createOrUpdateInstallation, SeekaAppInstallState } from "../../state/seeka/installations";
+
+export const setTrackingSettings = async (installation: SeekaAppInstallState, req: HttpRequest, context: InvocationContext, logger: Logger): Promise<HttpResponseInit> => {
+    // Validate
+    const body = (await req.json()) as any;
+    const tracking = body as YeastarTrackingSettings | undefined;
+    if (!tracking) {
+        return {
+            status: 400,
+            jsonBody: { error: 'body is required' }
+        };
+    }
+
+    installation.installationState = {
+        ...installation.installationState,
+        tracking
+    };
+    await createOrUpdateInstallation(installation, logger);
+
+    return {
+        status: 200
+    };
+}

package/dist/ai-context/internal/examples/v2/yeastar/app/server/src/lib/api/routes/yeastar/config/YeastarTemplate.xml

@@ -0,0 +1,138 @@
+<Information Provider="crm" Name="Seeka" Key="" Logo="e9b10014-e126-4c47-a05d-37b85da9dd27_blob" Remark="" Version="" AuthType="none" MaxConcurrentRequest="10" UserAssociation="1" CallJournal="1" CreateNewContact="1" CreateNewTicket="0">
+ <Parameters></Parameters>
+ <Scenarios>
+  <Scenario Id="AuthMethod" Type="AUTH" MultiVersion="false">
+   <Presets></Presets>
+   <Parameters>
+    <Parameter Name="AuthMethod" Value="none"></Parameter>
+    <Parameter Name="AuthEndPoint"></Parameter>
+    <Parameter Name="TokenEndPoint"></Parameter>
+    <Parameter Name="AdditionalQueryString"></Parameter>
+    <Parameter Name="Scope"></Parameter>
+    <Parameter Name="CredentialType"></Parameter>
+    <Parameter Name="Base64EncodedCredential"></Parameter>
+   </Parameters>
+   <Requests></Requests>
+  </Scenario>
+  <Scenario Id="SyncContactAuto" Type="REST" MultiVersion="false">
+   <Presets></Presets>
+   <Parameters>
+    <Parameter Name="ContactUrlType" Value="specify_url_format"></Parameter>
+    <Parameter Name="URLFormat" Value="{{{apiBaseUrl}}}/api/yeastar/{{{appInstallId}}}/contacts/{{.ContactId}}/popup"></Parameter>
+    <Parameter Name="ContactFieldForUri"></Parameter>
+    <Parameter Name="ContactsIdEnable" Value="1"></Parameter>
+    <Parameter Name="FirstNameEnable" Value="1"></Parameter>
+    <Parameter Name="LastNameEnable" Value="1"></Parameter>
+    <Parameter Name="CompanyEnable" Value="0"></Parameter>
+    <Parameter Name="EmailEnable" Value="1"></Parameter>
+    <Parameter Name="BusinessNumberEnable" Value="0"></Parameter>
+    <Parameter Name="BusinessNumber2Enable" Value="0"></Parameter>
+    <Parameter Name="BusinessFaxNumberEnable" Value="0"></Parameter>
+    <Parameter Name="MobileNumberEnable" Value="1"></Parameter>
+    <Parameter Name="MobileNumber2Enable" Value="0"></Parameter>
+    <Parameter Name="HomeNumberEnable" Value="0"></Parameter>
+    <Parameter Name="HomeNumber2Enable" Value="0"></Parameter>
+    <Parameter Name="HomeFaxNumberEnable" Value="0"></Parameter>
+    <Parameter Name="OtherNumberEnable" Value="0"></Parameter>
+    <Parameter Name="ZipCodeEnable" Value="0"></Parameter>
+    <Parameter Name="StreetEnable" Value="0"></Parameter>
+    <Parameter Name="CityEnable" Value="0"></Parameter>
+    <Parameter Name="StateEnable" Value="0"></Parameter>
+    <Parameter Name="CountryEnable" Value="0"></Parameter>
+    <Parameter Name="RemarkEnable" Value="0"></Parameter>
+    <Parameter Name="CustomValueEnable" Value="0"></Parameter>
+   </Parameters>
+   <Requests>
+    <Request Name="Contacts" Method="GET" Weight="0" ResponseType="application/json" RequestEncoding="" URLFormat="{{{apiBaseUrl}}}/api/yeastar/{{{appInstallId}}}/contacts/search?phone={{.Phone}}">
+     <Parameters></Parameters>
+     <Outputs>
+      <Output Name="ContactsId" Path="data.#.contact_id" Type=""></Output>
+      <Output Name="FirstName" Path="data.#.name" Type=""></Output>
+      <Output Name="LastName" Path="data.#.last_name" Type=""></Output>
+      <Output Name="Company" Path="" Type=""></Output>
+      <Output Name="Email" Path="data.#.email" Type=""></Output>
+      <Output Name="BusinessNumber" Path="" Type=""></Output>
+      <Output Name="BusinessNumber2" Path="" Type=""></Output>
+      <Output Name="BusinessFaxNumber" Path="" Type=""></Output>
+      <Output Name="MobileNumber" Path="data.#.mobile" Type=""></Output>
+      <Output Name="MobileNumber2" Path="" Type=""></Output>
+      <Output Name="HomeNumber" Path="" Type=""></Output>
+      <Output Name="HomeNumber2" Path="" Type=""></Output>
+      <Output Name="HomeFaxNumber" Path="" Type=""></Output>
+      <Output Name="OtherNumber" Path="" Type=""></Output>
+      <Output Name="ZipCode" Path="" Type=""></Output>
+      <Output Name="Street" Path="" Type=""></Output>
+      <Output Name="City" Path="" Type=""></Output>
+      <Output Name="State" Path="" Type=""></Output>
+      <Output Name="Country" Path="" Type=""></Output>
+      <Output Name="Remark" Path="" Type=""></Output>
+      <Output Name="CustomValue" Path="data.#.seeka_id" Type=""></Output>
+     </Outputs>
+    </Request>
+   </Requests>
+  </Scenario>
+  <Scenario Id="UserAssociation" Type="REST" MultiVersion="false">
+   <Presets></Presets>
+   <Parameters></Parameters>
+   <Requests>
+    <Request Name="UserAssociation" Method="GET" Weight="0" ResponseType="application/json" RequestEncoding="" URLFormat="{{{apiBaseUrl}}}/api/yeastar/{{{appInstallId}}}/users">
+     <Parameters></Parameters>
+     <Outputs>
+      <Output Name="UserUniqueId" Path="data.#.user_unique_id" Type=""></Output>
+      <Output Name="FirstName" Path="data.#.first_name" Type=""></Output>
+      <Output Name="LastName" Path="data.#.last_name" Type=""></Output>
+      <Output Name="Email" Path="data.#.email" Type=""></Output>
+     </Outputs>
+    </Request>
+   </Requests>
+  </Scenario>
+  <Scenario Id="CreateNewContact" Type="REST" MultiVersion="false">
+   <Presets></Presets>
+   <Parameters></Parameters>
+   <Requests>
+    <Request Name="Contact" Method="POST" Weight="0" ResponseType="application/json" RequestEncoding="" URLFormat="{{{apiBaseUrl}}}/api/yeastar/{{{appInstallId}}}/contacts">
+     <Parameters>
+      <Parameter Name="Data" Type="Body" Value="{&#xA;  &#34;data&#34;: [&#xA;    {&#xA;      &#34;First_Name&#34;: &#34;{{.FirstName}}&#34;,&#xA;      &#34;Last_Name&#34;: &#34;{{.LastName}}&#34;,&#xA;      &#34;Company&#34;: &#34;{{.Company}}&#34;,&#xA;      &#34;Email&#34;: &#34;{{.Email}}&#34;,&#xA;      &#34;Phone&#34;: &#34;{{.BusinessNumber}}&#34;,&#xA;      &#34;Mobile&#34;: &#34;{{.MobileNumber}}&#34;,&#xA;      &#34;Home_Phone&#34;: &#34;{{.HomeNumber}}&#34;,&#xA;      &#34;Other_Phone&#34;: &#34;{{.OtherNumber}}&#34;,&#xA;      &#34;Fax&#34;: &#34;{{.Fax}}&#34;,&#xA;      &#34;Job_Title&#34;: &#34;{{.JobTitle}}&#34;,&#xA;      &#34;Department&#34;: &#34;{{.Department}}&#34;,&#xA;      &#34;Street&#34;: &#34;{{.Street}}&#34;,&#xA;      &#34;City&#34;: &#34;{{.City}}&#34;,&#xA;      &#34;State&#34;: &#34;{{.State}}&#34;,&#xA;      &#34;Zip_Code&#34;: &#34;{{.ZipCode}}&#34;,&#xA;      &#34;Country&#34;: &#34;{{.Country}}&#34;,&#xA;      &#34;Website&#34;: &#34;{{.Website}}&#34;,&#xA;      &#34;Notes&#34;: &#34;{{.Note}}&#34;&#xA;    }&#xA;  ]&#xA;}"></Parameter>
+     </Parameters>
+     <Outputs></Outputs>
+    </Request>
+   </Requests>
+  </Scenario>
+  <Scenario Id="CallJournal" Type="REST" MultiVersion="false">
+   <Presets></Presets>
+   <Parameters>
+    <Parameter Name="EnableSubject" Value="1"></Parameter>
+    <Parameter Name="Subject" Value="Extension Call"></Parameter>
+    <Parameter Name="EnableDescription" Value="1"></Parameter>
+    <Parameter Name="Description" Value="Call: {{.Time}} {{.Call_Log_Status}} from {{.Call_From}} to {{.Call_To}} {{.Talk_Duration}}"></Parameter>
+    <Parameter Name="EnablePlayCallRecording" Value="1"></Parameter>
+    <Parameter Name="PlayCallRecording" Value="1"></Parameter>
+   </Parameters>
+   <Requests>
+    <Request Name="CallJournal" Method="POST" Weight="0" ResponseType="application/json" RequestEncoding="" URLFormat="{{{apiBaseUrl}}}/api/yeastar/{{{appInstallId}}}/call/journal">
+     <Parameters>
+      <Parameter Name="Data" Type="Body" Value="{&#xA;  &#34;Call_From&#34;: &#34;{{.Call_From}}&#34;,&#xA;  &#34;Call_To&#34;: &#34;{{.Call_To}}&#34;,&#xA;  &#34;Call_Log_Status&#34;: &#34;{{.Call_Log_Status}}&#34;,&#xA;  &#34;StartTimeUnix&#34;: &#34;{{.StartTimeUnix}}&#34;,&#xA;  &#34;EndTimeUnix&#34;: &#34;{{.EndTimeUnix}}&#34;,&#xA;  &#34;StartTime&#34;: &#34;{{.StartTime}}&#34;,&#xA;  &#34;EndTime&#34;: &#34;{{.EndTime}}&#34;,&#xA;  &#34;Talk_Duration&#34;: &#34;{{.Talk_Duration}}&#34;,&#xA;  &#34;Talk_Duration_Sec&#34;: &#34;{{.Talk_Duration_Sec}}&#34;,&#xA;  &#34;Ring_Duration&#34;: &#34;{{.Ring_Duration}}&#34;,&#xA;  &#34;Ring_Duration_Sec&#34;: &#34;{{.Ring_Duration_Sec}}&#34;,&#xA;  &#34;Description&#34;: &#34;{{.Description}}&#34;,&#xA;  &#34;Subject&#34;: &#34;{{.Subject}}&#34;,&#xA;  &#34;RecordPath&#34;: &#34;{{.RecordPath}}&#34;,&#xA;  &#34;CallerName&#34;: &#34;{{.CallerName}}&#34;,&#xA;  &#34;CalleeName&#34;: &#34;{{.CalleeName}}&#34;,&#xA;  &#34;Direction&#34;: &#34;{{.Direction}}&#34;,&#xA;  &#34;CallType&#34;: &#34;{{.CallType}}&#34;,&#xA;  &#34;TrunkName&#34;: &#34;{{.TrunkName}}&#34;,&#xA;  &#34;TrunkID&#34;: &#34;{{.TrunkID}}&#34;,&#xA;  &#34;Extension&#34;: &#34;{{.Extension}}&#34;,&#xA;  &#34;ExtensionName&#34;: &#34;{{.ExtensionName}}&#34;,&#xA;  &#34;ExtensionOutboundCallerID&#34;: &#34;{{.ExtensionOutboundCallerID}}&#34;,&#xA;  &#34;ExtensionOutboundCallerIDName&#34;: &#34;{{.ExtensionOutboundCallerIDName}}&#34;,&#xA;  &#34;UniqueID&#34;: &#34;{{.UniqueID}}&#34;,&#xA;  &#34;CallerIDNum&#34;: &#34;{{.CallerIDNum}}&#34;,&#xA;  &#34;CalleeIDNum&#34;: &#34;{{.CalleeIDNum}}&#34;,&#xA;  &#34;CallID&#34;: &#34;{{.CallID}}&#34;,&#xA;  &#34;Contact_ID&#34;: &#34;{{.ContactID}}&#34;&#xA;}&#xA;"></Parameter>
+     </Parameters>
+     <Outputs></Outputs>
+    </Request>
+   </Requests>
+  </Scenario>
+  <Scenario Id="CreateNewTicket" Type="REST" MultiVersion="false">
+   <Presets></Presets>
+   <Parameters>
+    <Parameter Name="EnableSubject" Value="0"></Parameter>
+    <Parameter Name="Subject"></Parameter>
+    <Parameter Name="EnableDescription" Value="0"></Parameter>
+    <Parameter Name="Description"></Parameter>
+   </Parameters>
+   <Requests>
+    <Request Name="CreateNewTicket" Method="POST" Weight="0" ResponseType="application/json" RequestEncoding="" URLFormat="">
+     <Parameters>
+      <Parameter Name="Data" Type="Body"></Parameter>
+     </Parameters>
+     <Outputs></Outputs>
+    </Request>
+   </Requests>
+  </Scenario>
+ </Scenarios>
+</Information>

package/dist/ai-context/internal/examples/v2/yeastar/app/server/src/lib/api/routes/yeastar/config/getYeastarCrmConfig.ts

@@ -0,0 +1,30 @@
+import { HttpRequest, HttpResponseInit, InvocationContext } from "@azure/functions";
+import { promises as fs } from 'fs';
+import { join } from 'path';
+import { Logger } from "winston";
+import { SeekaAppInstallState } from "../../../../state/seeka/installations";
+
+function escapeRegex(string) {
+    return string.replace(/[.*+?^${}()|[\]\\]/g, '\\$&'); // Escape special characters
+}
+
+export const getYeastarCrmConfig = async (installation: SeekaAppInstallState, req: HttpRequest, context: InvocationContext, logger: Logger): Promise<HttpResponseInit> => {
+    // get content of YeastarTemplate.xml
+
+    const xmlPath = join(__dirname, 'YeastarTemplate.xml');
+    let template = await fs.readFile(xmlPath, 'utf8');
+
+    template = template.replace(new RegExp(escapeRegex('{{{apiBaseUrl}}}'), 'g'), process.env.SELF_HOST_BASEURL);
+    template = template.replace(new RegExp(escapeRegex('{{{appInstallId}}}'), 'g'), installation.applicationInstallId);
+
+    //{{{apiBaseUrl}}}/api/yeastar/{{{appInstallId}}}
+
+    return {
+        status: 200,
+        headers: {
+            'Content-Type': 'application/xml',
+            'Content-Disposition': 'attachment; filename=YeastarSeekaCrmTemplate.xml'
+        },
+        body: template
+    };
+}

package/dist/ai-context/internal/examples/v2/yeastar/app/server/src/lib/api/routes/yeastar/users/setYeastarUsers.ts

@@ -0,0 +1,26 @@
+import { HttpRequest, HttpResponseInit, InvocationContext } from "@azure/functions";
+import { YeastarUserMapping } from "@seeka-app-yeastar/lib";
+import { Logger } from "winston";
+import { createOrUpdateInstallation, SeekaAppInstallState } from "../../../../state/seeka/installations";
+
+export const setYeastarUsers = async (installation: SeekaAppInstallState, req: HttpRequest, context: InvocationContext, logger: Logger): Promise<HttpResponseInit> => {
+    // Validate
+    const body = (await req.json()) as any;
+    const users = body.users as YeastarUserMapping[] | undefined;
+    if (!users) {
+        return {
+            status: 400,
+            jsonBody: { error: 'users is required' }
+        };
+    }
+
+    installation.installationState = {
+        ...installation.installationState,
+        yeastarUserMappings: users
+    };
+    await createOrUpdateInstallation(installation, logger);
+
+    return {
+        status: 200
+    };
+}

package/dist/ai-context/internal/examples/v2/yeastar/app/server/src/lib/jobs/index.ts

@@ -0,0 +1,72 @@
+import { QueueClient } from '@azure/storage-queue';
+import type { Logger } from 'winston';
+
+export interface BackgroundJobRequestContext<TPayload> {
+    organisationId?: string;
+    organisationBrandId?: string;
+    applicationInstallId?: string;
+    causationId?: string
+    correlationId?: string
+    payload: TPayload
+}
+
+export const signatureHeaderName = 'x-signature-hmac';
+export const apiKeyHeaderName = 'x-api-key';
+
+export const queueNames = {
+    trackYeastarConversion: 'yeastar-conversion-track-queue',
+}
+
+export const triggerBackgroundJob = async <TPayload>(queueName: string, context: BackgroundJobRequestContext<TPayload>, logger: Logger): Promise<void> => {
+    const queueClient = new QueueClient(process.env.AzureWebJobsStorage as string, queueName);
+    return triggerBackgroundJobWithQueue(queueClient, context, logger);
+}
+
+const serialiseQueuePayload = (payload: unknown): string => {
+    const jsonString = JSON.stringify(payload)
+    return Buffer.from(jsonString).toString('base64')
+}
+
+export const deserialiseQueuePayload = <TPayload>(payload: string): TPayload => {
+    const jsonString = Buffer.from(payload, 'base64').toString()
+    return JSON.parse(jsonString) as TPayload;
+}
+
+export const triggerBackgroundJobWithQueue = async <TPayload>(queueClient: QueueClient, context: BackgroundJobRequestContext<TPayload>, logger: Logger): Promise<void> => {
+    const body = {
+        ...context
+    }
+    const bodyStr = serialiseQueuePayload(body);
+
+    const response = await queueClient.sendMessage(bodyStr);
+
+    if (response.errorCode) {
+        const { requestId, date, errorCode } = response;
+        logger.error("Failed to trigger background job", { body, requestId, date, errorCode })
+        throw new Error(`Failed to trigger background job: ${response.errorCode}`);
+    }
+    else {
+        logger.info("Background job triggered for " + queueClient.name, { body, messageId: response.messageId, context })
+    }
+}
+
+export const sendQueueMessageToPoisonQueue = async <TPayload>(queueName: string, context: BackgroundJobRequestContext<TPayload>, logger: Logger): Promise<void> => {
+    const body = {
+        ...context
+    }
+    const bodyStr = serialiseQueuePayload(body);
+
+    // https://learn.microsoft.com/en-us/azure/azure-functions/functions-bindings-storage-queue-trigger?tabs=python-v2%2Cisolated-process%2Cnodejs-v4%2Cextensionv5&pivots=programming-language-typescript#poison-messages
+    const queueClient = new QueueClient(process.env.AzureWebJobsStorage as string, `${queueName}-poison`);
+
+    const response = await queueClient.sendMessage(bodyStr, { messageTimeToLive: -1 });
+
+    if (response.errorCode) {
+        const { requestId, date, errorCode } = response;
+        logger.error("Failed to push to poison queue", { body, requestId, date, errorCode })
+        throw new Error(`Failed to push to poison queue: ${response.errorCode}`);
+    }
+    else {
+        logger.verbose("Message pushed to poison queue", { body, messageId: response.messageId, context })
+    }
+}

package/dist/ai-context/internal/examples/v2/yeastar/app/server/src/lib/logging/index.ts

@@ -0,0 +1,98 @@
+import * as winston from 'winston';
+
+import { InvocationContext } from '@azure/functions';
+import { SeqTransport } from '@datalust/winston-seq';
+
+import * as packageJson from '../../../package.json';
+
+import type {
+    SeekaWebhookPayload, SeekaWebhookPayloadOfSeekaAppWebhookContext
+} from '@seeka-labs/sdk-apps-server';
+import { BackgroundJobRequestContext } from '../jobs';
+
+const loggerTransports: winston.transport[] = [
+    new winston.transports.Console({
+        level: process.env.LOGGING_LEVEL,
+        format: winston.format.combine(
+            winston.format.errors({ stack: true }),
+            winston.format.cli(),
+            winston.format.splat(),
+        ),
+        handleExceptions: true,
+        handleRejections: true,
+    }),
+]
+if (process.env.LOGGING_SEQ_SERVERURL) {
+    loggerTransports.push(
+        new SeqTransport({
+            level: process.env.LOGGING_LEVEL,
+            serverUrl: process.env.LOGGING_SEQ_SERVERURL,
+            apiKey: process.env.LOGGING_SEQ_APIKEY,
+            onError: ((e) => { console.error('Failed to configure Seq logging transport', e) }),
+            format: winston.format.combine(
+                winston.format.errors({ stack: true }),
+                winston.format.json(),
+            ),
+            handleExceptions: true,
+            handleRejections: true,
+        })
+    )
+}
+
+const defaultMeta = {
+    seekaAppId: process.env.SEEKA_APP_ID,
+    Hosting_Provider: 'azure',
+    Release_Version: `v${packageJson.version.split('-')[0]}`,
+    Hosting_Region: process.env.REGION_NAME,
+    Service_Instance_Id: process.env.WEBSITE_ROLE_INSTANCE_ID,
+    AzureFunctions_FunctionName: process.env.WEBSITE_SITE_NAME,
+    Service: `app/${packageJson.name}`,
+};
+
+export const logger = winston.createLogger({
+    level: process.env.LOGGING_LEVEL,
+    defaultMeta: {
+        ...defaultMeta
+    },
+    transports: loggerTransports,
+    exitOnError: false,
+});
+
+export const childLogger = (meta: object) => logger.child({ ...meta, defaultMeta });
+
+export const webhookLogger = (payload: SeekaWebhookPayload, functionContext: InvocationContext) => {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const meta: any = {
+        seekaWebhookType: payload.type,
+        seekaWebhookIsTest: payload.isTest,
+        RequestId: payload.requestId,
+        AzureFunctions_InvocationId: functionContext.invocationId,
+        CausationId: payload.causationId,
+        CorrelationId: payload.causationId,
+    }
+
+    const context = (payload as SeekaWebhookPayloadOfSeekaAppWebhookContext).context;
+    if (context) {
+        meta.seekaAppInstallId = context.applicationInstallId;
+        meta.seekaAppInstallOrganisationBrandId = context.organisationBrandId;
+        meta.seekaAppInstallOrganisationId = context.organisationId;
+    }
+
+    return childLogger(meta)
+}
+
+export const backgroundJobLogger = (jobName: string, jobContext: BackgroundJobRequestContext<any> | undefined, functionContext: InvocationContext) => {
+    const meta: object = {
+        jobContext,
+        jobName,
+        AzureFunctions_InvocationId: functionContext.invocationId,
+        CausationId: jobContext?.causationId,
+        CorrelationId: jobContext?.causationId,
+        seekaAppInstallId: jobContext?.applicationInstallId,
+        seekaAppInstallOrganisationBrandId: jobContext?.organisationBrandId,
+        seekaAppInstallOrganisationId: jobContext?.organisationId,
+        ...defaultMeta
+    }
+
+    return childLogger(meta)
+}

package/dist/ai-context/internal/examples/v2/yeastar/app/server/src/lib/services/index.ts

@@ -0,0 +1,41 @@
+import winston, { Logger } from 'winston';
+
+import { connect, disconnect, isConnected } from '../state/redis';
+
+export const startServices = async (logger: Logger) => {
+    logger.debug(`Trying to connect to Redis - ${process.env.REDIS_CONNECTION_HOST}`)
+    try {
+        if (isConnected()) {
+            logger.verbose(`Redis already connected - ${process.env.REDIS_CONNECTION_HOST}`)
+        }
+        else {
+            logger.profile('service.redis.connect')
+            await connect();
+            logger.profile('service.redis.connect')
+            logger.debug(`Redis connected - ${process.env.REDIS_CONNECTION_HOST}`)
+        }
+    }
+    catch (err) {
+        logger.error(`Failed to connect to Redis - ${process.env.REDIS_CONNECTION_HOST}`, { ex: winston.exceptions.getAllInfo(err) })
+        throw err;
+    }
+}
+
+export const stopServices = async (logger: Logger) => {
+    logger.debug(`Trying to disconnect from Redis - ${process.env.REDIS_CONNECTION_HOST}`)
+    try {
+        if (isConnected() === false) {
+            logger.verbose(`Redis already disconnected - ${process.env.REDIS_CONNECTION_HOST}`)
+        }
+        else {
+            logger.profile('service.redis.disconnect')
+            await disconnect();
+            logger.profile('service.redis.disconnect')
+            logger.verbose(`Redis disconnected - ${process.env.REDIS_CONNECTION_HOST}`)
+        }
+    }
+    catch (err) {
+        logger.error(`Failed to disconnect from Redis - ${process.env.REDIS_CONNECTION_HOST}`, { ex: winston.exceptions.getAllInfo(err) })
+        throw err;
+    }
+}

package/dist/ai-context/internal/examples/v2/yeastar/app/server/src/lib/state/redis/index.ts

@@ -0,0 +1,102 @@
+import { createClient, RedisClientType } from 'redis';
+
+import * as winston from 'winston';
+import { logger } from '../../logging';
+
+const redisProtocol = process.env.REDIS_CONNECTION_TLS === 'true' ? 'rediss://' : 'redis://';
+const redisConn = `${redisProtocol}${process.env.REDIS_CONNECTION_USER}:${process.env.REDIS_CONNECTION_PASSWORD}@${process.env.REDIS_CONNECTION_HOST}:${process.env.REDIS_CONNECTION_PORT}`;
+
+export const createNewClient = (): RedisClientType => {
+    const c = createClient({
+        url: redisConn,
+        disableClientInfo: true,
+
+    })
+        .on('error', (err) => logger.error('Redis Client ', { ex: winston.exceptions.getAllInfo(err) }));
+
+    return c as RedisClientType
+}
+
+const redisClient = createNewClient()
+
+export const connect = async () => {
+    await redisClient.connect();
+}
+
+export const isConnected = () => {
+    return redisClient.isOpen;
+}
+
+export const disconnect = async () => {
+    await redisClient.destroy();
+}
+
+const getKeyPrefix = (stateType: string) => `seeka:app:${process.env.SEEKA_APP_ID}:${stateType}`
+export const getKey = (stateType: string, key: string) => `${getKeyPrefix(stateType)}:${key}`
+
+export async function getOrCreate<TState>(stateType: string, key: string, toCreate: TState, mode: 'string' | 'json' = 'string'): Promise<TState> {
+    const fullKey = getKey(stateType, key);
+    const existingStr = await getString(redisClient, fullKey);
+    if (existingStr) return JSON.parse(existingStr);
+
+    if (mode === 'json') {
+        await redisClient.json.set(fullKey, '$', toCreate as never);
+    }
+    else {
+        await redisClient.set(fullKey, JSON.stringify(toCreate));
+    }
+
+    return toCreate;
+}
+
+export async function tryGet<TState>(stateType: string, key: string, mode: 'string' | 'json' = 'string'): Promise<TState | null> {
+    const fullKey = getKey(stateType, key);
+
+    if (mode === 'json') {
+        const existing = await redisClient.json.get(fullKey);
+        if (existing) return existing as TState;
+    }
+    else {
+        const existingStr = await getString(redisClient, fullKey);
+        if (existingStr) return JSON.parse(existingStr);
+    }
+
+    return null;
+}
+
+export async function getList<TState>(stateType: string): Promise<TState[]> {
+    const prefix = getKeyPrefix(stateType);
+    const allKeys = await redisClient.keys(`${prefix}:*`);
+    const listStr = await redisClient.mGet(allKeys);
+
+    if (listStr) return listStr.filter(e => Boolean(e)).map(e => JSON.parse(e as string));
+
+    return [];
+}
+
+export async function set<TState>(stateType: string, key: string, toCreate: TState, mode: 'string' | 'json' = 'string'): Promise<void> {
+    const fullKey = getKey(stateType, key);
+
+    if (mode === 'json') {
+        await redisClient.json.set(fullKey, '$', toCreate as never);
+    }
+    else {
+        await redisClient.set(fullKey, JSON.stringify(toCreate));
+    }
+}
+
+export async function remove(stateType: string, key: string): Promise<void> {
+    const fullKey = getKey(stateType, key);
+    await redisClient.del(fullKey);
+}
+
+async function getString(redisClient: any, key: string): Promise<string> {
+    const result = await redisClient.get(key);
+    if (typeof result === 'string') {
+        return result;
+    }
+    if (result) {
+        return result.toString();
+    }
+    return '';
+}