@cellaware/utils 8.11.19 → 8.11.21

package/dist/chatwms/teams.d.ts

@@ -0,0 +1,237 @@
+export declare function createTeamsTableItem(rows: any[]): ({
+    type: string;
+    cells: {
+        type: string;
+        items: {
+            type: string;
+            text: any;
+            size: string;
+            weight: string;
+        }[];
+    }[];
+} | {
+    type: string;
+    style: string | undefined;
+    cells: {
+        type: string;
+        style: string | undefined;
+        items: {
+            type: string;
+            text: any;
+            size: string;
+            color: string | undefined;
+            weight: string | undefined;
+            isSubtle: true | undefined;
+        }[];
+    }[];
+})[];
+export declare function createTeamsReportBriefCard(briefMarkdown: string, reportTitle: string): {
+    type: string;
+    version: string;
+    msteams: {
+        width: string;
+    };
+    body: ({
+        type: string;
+        facts: {
+            title: string;
+            value: string;
+        }[];
+    } | {
+        type: string;
+        text: string;
+        size: string;
+        isSubtle: boolean;
+        wrap: boolean;
+    } | {
+        type: string;
+        separator: boolean;
+        items: {
+            type: string;
+            text: string;
+            wrap: boolean;
+        }[];
+    })[];
+};
+export declare function createTeamsReportTableCard(lineTitle: string, table: any[], summary: string, reportTitle: string): {
+    type: string;
+    version: string;
+    msteams: {
+        width: string;
+    };
+    body: ({
+        type: string;
+        facts: {
+            title: string;
+            value: string;
+        }[];
+    } | {
+        type: string;
+        separator: boolean;
+        text: string;
+        size: string;
+    } | {
+        type: string;
+        text: string;
+        size: string;
+        isSubtle: boolean;
+        wrap: boolean;
+    } | {
+        type: string;
+        roundedCorners: boolean;
+        firstRowAsHeaders: boolean;
+        columns: any;
+        rows: any[];
+    })[];
+};
+export declare function createTeamsReportValueCard(lineTitle: string, columnName: string, value: any, styles: string[], summary: string, reportTitle: string): {
+    type: string;
+    version: string;
+    msteams: {
+        width: string;
+    };
+    body: ({
+        type: string;
+        facts: {
+            title: string;
+            value: string;
+        }[];
+    } | {
+        type: string;
+        text: string;
+        size: string;
+        isSubtle: boolean;
+        wrap: boolean;
+    } | {
+        type: string;
+        separator: boolean;
+        roundedCorners: boolean;
+        style: string | undefined;
+        items: {
+            type: string;
+            text: any;
+            wrap: boolean;
+            size: string;
+            color: string | undefined;
+            weight: string | undefined;
+            isSubtle: true | undefined;
+        }[];
+    })[];
+};
+export declare function createTeamsReportRowCard(lineTitle: string, table: any[], summary: string, reportTitle: string): {
+    type: string;
+    version: string;
+    msteams: {
+        width: string;
+    };
+    body: ({
+        type: string;
+        facts: {
+            title: string;
+            value: string;
+        }[];
+    } | {
+        type: string;
+        text: string;
+        size: string;
+        isSubtle: boolean;
+        wrap: boolean;
+    } | {
+        type: string;
+        roundedCorners: boolean;
+        columns: {
+            width: number;
+        }[];
+        rows: any[];
+    })[];
+};
+export declare function createTeamsReportChartCard(lineTitle: string, png: string, summary: string, reportTitle: string): {
+    type: string;
+    version: string;
+    msteams: {
+        width: string;
+    };
+    body: ({
+        type: string;
+        facts: {
+            title: string;
+            value: string;
+        }[];
+    } | {
+        type: string;
+        text: string;
+        size: string;
+        isSubtle: boolean;
+        wrap: boolean;
+    } | {
+        type: string;
+        separator: boolean;
+        url: string;
+    })[];
+};
+export declare function createTeamsAlertTableCard(condition: string, rows: any[], alertTitle: string): {
+    type: string;
+    version: string;
+    msteams: {
+        width: string;
+    };
+    body: ({
+        type: string;
+        facts: {
+            title: string;
+            value: string;
+        }[];
+    } | {
+        type: string;
+        separator: boolean;
+        text: string;
+        size: string;
+    } | {
+        type: string;
+        roundedCorners: boolean;
+        firstRowAsHeaders: boolean;
+        columns: {
+            width: number;
+        }[];
+        rows: ({
+            type: string;
+            cells: {
+                type: string;
+                items: {
+                    type: string;
+                    text: any;
+                    size: string;
+                    weight: string;
+                }[];
+            }[];
+        } | {
+            type: string;
+            style: string | undefined;
+            cells: {
+                type: string;
+                style: string | undefined;
+                items: {
+                    type: string;
+                    text: any;
+                    size: string;
+                    color: string | undefined;
+                    weight: string | undefined;
+                    isSubtle: true | undefined;
+                }[];
+            }[];
+        })[];
+        text?: undefined;
+        size?: undefined;
+        style?: undefined;
+    } | {
+        type: string;
+        text: string;
+        size: string;
+        style: string;
+        roundedCorners?: undefined;
+        firstRowAsHeaders?: undefined;
+        columns?: undefined;
+        rows?: undefined;
+    })[];
+};
+export declare function sendTeamsWebhook(url: string, card: any): Promise<Response>;

package/dist/chatwms/teams.js

@@ -0,0 +1,205 @@
+import { createTeamsTableColumns, createTeamsTableRow, DATAGRID_HTML_COLS, DATAGRID_TEAMS_ROWS, mapTeamsStyles } from "./datagrid.js";
+function createTeamsTitleItem(title, value) {
+    return {
+        type: "FactSet",
+        facts: [
+            {
+                title: `${title}:`,
+                value
+            }
+        ]
+    };
+}
+function createTeamsTableQualifierItem() {
+    return {
+        type: "TextBlock",
+        separator: true,
+        text: `Displaying first **${DATAGRID_TEAMS_ROWS} rows** and **${DATAGRID_HTML_COLS} columns**`,
+        size: "Small"
+    };
+}
+function createTeamsSummaryItem(summary) {
+    return {
+        type: "TextBlock",
+        text: `*${summary}*`,
+        size: "Small",
+        isSubtle: true,
+        wrap: true
+    };
+}
+export function createTeamsTableItem(rows) {
+    if (rows.length === 0) {
+        return [];
+    }
+    const columnNames = Object.keys(rows[0]);
+    const teamsRows = rows.map(row => createTeamsTableRow(columnNames, columnNames.map(col => row[col])));
+    return [
+        createTeamsTableColumns(columnNames),
+        ...teamsRows
+    ];
+}
+export function createTeamsReportBriefCard(briefMarkdown, reportTitle) {
+    return {
+        type: "AdaptiveCard",
+        version: "1.5",
+        msteams: { width: "Full" },
+        body: [
+            createTeamsTitleItem(reportTitle, 'Brief'),
+            {
+                type: "Container",
+                separator: true,
+                items: [
+                    {
+                        type: "TextBlock",
+                        text: briefMarkdown,
+                        wrap: true,
+                    }
+                ]
+            },
+            createTeamsSummaryItem('ChatWMS can make mistakes. [Check important info.](https://chatwms.io/user-manual/chatwms/disclaimer)')
+        ]
+    };
+}
+export function createTeamsReportTableCard(lineTitle, table, summary, reportTitle) {
+    return {
+        type: "AdaptiveCard",
+        version: "1.5",
+        msteams: { width: "Full" },
+        body: [
+            createTeamsTitleItem(reportTitle, lineTitle),
+            createTeamsTableQualifierItem(),
+            {
+                type: "Table",
+                roundedCorners: true,
+                firstRowAsHeaders: true,
+                columns: table.length === 0 ? [] : table[0].cells.map(() => ({ width: 3 })),
+                rows: table
+            },
+            createTeamsSummaryItem(summary)
+        ]
+    };
+}
+export function createTeamsReportValueCard(lineTitle, columnName, value, styles, summary, reportTitle) {
+    // NOTE: we only care about mapping style string (represented as row styles) to column styles.
+    let rowStyles = [];
+    let columnStyles = [];
+    [rowStyles, columnStyles] = mapTeamsStyles([columnName], styles, [], rowStyles, columnStyles);
+    let color = undefined;
+    let style = undefined;
+    let weight = undefined;
+    let isSubtle = undefined;
+    let italic = undefined;
+    if (columnStyles.length > 0) {
+        const columnStyle = columnStyles[0];
+        for (const columnStyleAttributes of columnStyle.styles) {
+            if (!!columnStyleAttributes.color) {
+                color = columnStyleAttributes.color;
+            }
+            if (!!columnStyleAttributes.style) {
+                style = columnStyleAttributes.style;
+            }
+            if (!!columnStyleAttributes.weight) {
+                weight = columnStyleAttributes.weight;
+            }
+            if (!!columnStyleAttributes.isSubtle) {
+                isSubtle = columnStyleAttributes.isSubtle;
+            }
+            if (!!columnStyleAttributes.italic) {
+                italic = columnStyleAttributes.italic;
+            }
+        }
+    }
+    return {
+        type: "AdaptiveCard",
+        version: "1.5",
+        msteams: { width: "Full" },
+        body: [
+            createTeamsTitleItem(reportTitle, lineTitle),
+            {
+                type: "Container",
+                separator: true,
+                roundedCorners: true,
+                style,
+                items: [
+                    {
+                        type: "TextBlock",
+                        text: italic ? `*${value}*` : value,
+                        wrap: true,
+                        size: "ExtraLarge",
+                        color,
+                        weight,
+                        isSubtle
+                    }
+                ]
+            },
+            createTeamsSummaryItem(summary)
+        ]
+    };
+}
+export function createTeamsReportRowCard(lineTitle, table, summary, reportTitle) {
+    return {
+        type: "AdaptiveCard",
+        version: "1.5",
+        msteams: { width: "Full" },
+        body: [
+            createTeamsTitleItem(reportTitle, lineTitle),
+            {
+                type: "Table",
+                roundedCorners: true,
+                columns: [{ width: 1 }, { width: 2 }],
+                rows: table
+            },
+            createTeamsSummaryItem(summary)
+        ]
+    };
+}
+export function createTeamsReportChartCard(lineTitle, png, summary, reportTitle) {
+    return {
+        type: "AdaptiveCard",
+        version: "1.5",
+        msteams: { width: "Full" },
+        body: [
+            createTeamsTitleItem(reportTitle, lineTitle),
+            {
+                type: "Image",
+                separator: true,
+                url: png,
+            },
+            createTeamsSummaryItem(summary)
+        ]
+    };
+}
+export function createTeamsAlertTableCard(condition, rows, alertTitle) {
+    const table = createTeamsTableItem(rows);
+    return {
+        type: "AdaptiveCard",
+        version: "1.5",
+        msteams: { width: "Full" },
+        body: [
+            createTeamsTitleItem(alertTitle, condition),
+            createTeamsTableQualifierItem(),
+            {
+                type: "Table",
+                roundedCorners: true,
+                firstRowAsHeaders: true,
+                columns: table.length === 0 ? [] : table[0].cells.map(() => ({ width: 3 })),
+                rows: table
+            },
+            {
+                type: "Badge",
+                text: "Alert",
+                size: "Large",
+                style: "Attention"
+            }
+        ]
+    };
+}
+export async function sendTeamsWebhook(url, card) {
+    return fetch(url, {
+        method: "POST",
+        headers: {
+            "content-type": "application/json"
+        },
+        body: JSON.stringify(card),
+    });
+}

package/dist/chatwms/user.d.ts

@@ -0,0 +1,31 @@
+import { HttpRequest } from "@azure/functions";
+export interface ChatWMSUserData {
+    userId: string;
+    userDetails: string;
+    identityProvider: string;
+}
+export declare function chatwmsInitUserData(): ChatWMSUserData;
+/**
+ * NOTE: will throw error if empty principal or decode issue
+ */
+export declare function chatwmsExtractUserDataFromHeaders(request: HttpRequest): ChatWMSUserData;
+export declare const CHATWMS_DEFAULT_LANGUAGE: string;
+export type ChatWMSTheme = 'light' | 'dark';
+export declare const CHATWMS_THEME_LIGHT: ChatWMSTheme;
+export declare const CHATWMS_THEME_DARK: ChatWMSTheme;
+export type ChatWMSAnalystOption = 'conversational' | 'direct';
+export declare const CHATWMS_ANALYST_OPTION_CONVERSATIONAL: ChatWMSAnalystOption;
+export declare const CHATWMS_ANALYST_OPTION_DIRECT: ChatWMSAnalystOption;
+export type ChatWMSDateFormat = 'MMDDYYYY' | 'DDMMYYYY' | 'YYYYMMDD';
+export declare const CHATWMS_DEFAULT_DATE_FORMAT: ChatWMSDateFormat;
+export interface ChatWMSUserSettings {
+    userId: string;
+    userDetails: string;
+    language: string;
+    theme: ChatWMSTheme;
+    analystOption?: ChatWMSAnalystOption;
+    developer?: boolean;
+    dateFormat?: ChatWMSDateFormat;
+    clientId: string;
+}
+export declare function chatwmsInitUserSettings(): ChatWMSUserSettings;

package/dist/chatwms/user.js

@@ -0,0 +1,42 @@
+import { AZURE_HEADER_PRINCIPAL } from "../azure/function.js";
+export function chatwmsInitUserData() {
+    return {
+        userId: '',
+        userDetails: '',
+        identityProvider: ''
+    };
+}
+/**
+ * NOTE: will throw error if empty principal or decode issue
+ */
+export function chatwmsExtractUserDataFromHeaders(request) {
+    // https://learn.microsoft.com/en-us/azure/static-web-apps/user-information
+    const principal = request.headers.get(AZURE_HEADER_PRINCIPAL) ?? '';
+    if (principal !== '') {
+        try {
+            const userData = JSON.parse(Buffer.from(principal, 'base64').toString('utf8'));
+            return userData;
+        }
+        catch (err) {
+            throw new Error(`Authorization error`);
+        }
+    }
+    else {
+        throw new Error(`Authorization header not found`);
+    }
+}
+export const CHATWMS_DEFAULT_LANGUAGE = 'English';
+export const CHATWMS_THEME_LIGHT = 'light';
+export const CHATWMS_THEME_DARK = 'dark';
+export const CHATWMS_ANALYST_OPTION_CONVERSATIONAL = 'conversational';
+export const CHATWMS_ANALYST_OPTION_DIRECT = 'direct';
+export const CHATWMS_DEFAULT_DATE_FORMAT = 'MMDDYYYY';
+export function chatwmsInitUserSettings() {
+    return {
+        userId: '',
+        userDetails: '',
+        language: CHATWMS_DEFAULT_LANGUAGE,
+        theme: CHATWMS_THEME_LIGHT,
+        clientId: ''
+    };
+}

package/dist/chatwms/warehouse.d.ts

@@ -0,0 +1,3 @@
+export declare const WAREHOUSE_STATUS_HEALTHY = "healthy";
+export declare const WAREHOUSE_STATUS_INTERRUPTION = "interruption";
+export declare const WAREHOUSE_STATUS_OUTAGE = "outage";

package/dist/chatwms/warehouse.js

@@ -0,0 +1,3 @@
+export const WAREHOUSE_STATUS_HEALTHY = 'healthy';
+export const WAREHOUSE_STATUS_INTERRUPTION = 'interruption';
+export const WAREHOUSE_STATUS_OUTAGE = 'outage';

package/dist/github/issue.d.ts

@@ -0,0 +1 @@
+export declare function githubCreateIssue(issueUrl: string, issueTitle: string, issueBody: any, issueLabels: string[]): Promise<boolean>;

package/dist/github/issue.js

@@ -0,0 +1,23 @@
+export async function githubCreateIssue(issueUrl, issueTitle, issueBody, issueLabels) {
+    const token = process.env.GITHUB_TOKEN ?? '';
+    if (token.length === 0) {
+        throw new Error('GITHUB: `GITHUB_TOKEN` environment variable is not set');
+    }
+    const headers = {
+        'Authorization': `token ${token}`,
+        'X-GitHub-Api-Version': '2022-11-28',
+        'Accept': 'application/vnd.github+json'
+    };
+    const body = {
+        title: issueTitle,
+        body: issueBody,
+        labels: issueLabels
+    };
+    const req = {
+        method: 'POST',
+        headers,
+        body: JSON.stringify(body)
+    };
+    let res = await fetch(issueUrl, req);
+    return res.ok;
+}

package/dist/llm/chain-store.d.ts

@@ -0,0 +1,49 @@
+import { BaseChain } from 'langchain/chains';
+import { ModelName, ModelOptions } from './model.js';
+/**
+ * `SingleActionChain` only supports single interaction with LLM, and only 1
+ * output key is allowed. Output key is defaulted to `answer`.
+ */
+export declare class SingleActionChain extends BaseChain {
+    private _name;
+    private llm;
+    private _inputKeys;
+    private _outputKey;
+    private prompt;
+    private promptTemplate;
+    constructor(fields: any, name: string, inputKeys: string[]);
+    _call(values: any, runManager: any): Promise<any>;
+    _chainType(): string;
+    get inputKeys(): string[];
+    get outputKeys(): string[];
+    getModelName(): ModelName;
+    getPrompt(): string;
+}
+export declare function createSingleActionChain(name: string, modelName: ModelName, inputKeys: string[], prompt: string, temperature?: number, verbose?: boolean): SingleActionChain;
+/**
+ * A `ChainStore` is a chain registry and calling interface. The `ChainStore`
+ * keeps a map of all registered chains.
+ *
+ * The following chains are built-in:
+ *  - `translation_chain`: `translate()`
+ *
+ */
+export declare class ChainStore {
+    private promptsPath;
+    private chains;
+    constructor(promptsPath: string, defaultModelName?: ModelName);
+    private initBuiltinChains;
+    private static getTokenUsage;
+    private getPrompt;
+    /**
+     * - `name`: Chain name
+     * - `template`: Template chain name to copy prompt from
+     * - `options`: LLM options
+     * - `verbose`: OpenAI verbose parameter
+     */
+    addChain(name: string, template: string | null, options: ModelOptions, verbose?: boolean): void;
+    addExistingChain(chain: SingleActionChain): void;
+    callChain(name: string, args: any, tokenUsages: any[]): Promise<import("@langchain/core/utils/types.js").ChainValues>;
+    translate(statement: string, language: string, tokenUsages?: any[]): Promise<string>;
+    getPrompts(): string;
+}