@cellaware/utils 7.2.5 → 8.0.0

package/dist/chatwms/developer.d.ts

@@ -0,0 +1,27 @@
+import { KeyValuePair } from "../util.js";
+import { DataContext } from "./client.js";
+export interface SqlCacheContext {
+    contextName: DataContext;
+    variables: KeyValuePair[];
+    tables: {
+        table_name: string;
+        table_description: string;
+    }[];
+    columns: {
+        table_name: string;
+        column_id: number;
+        column_name: string;
+        data_type: string;
+        column_description: string;
+        column_comment: string;
+    }[];
+    functions: {
+        name: string;
+        type: string;
+        args: string[];
+        description: string;
+    }[];
+    tableMappings: KeyValuePair[];
+    columnMappings: KeyValuePair[];
+}
+export declare function initSqlCacheContext(): SqlCacheContext;

package/dist/chatwms/developer.js

@@ -0,0 +1,12 @@
+import { CHATWMS_CONTEXT_NAME } from "./client.js";
+export function initSqlCacheContext() {
+    return {
+        contextName: CHATWMS_CONTEXT_NAME,
+        variables: [],
+        tables: [],
+        columns: [],
+        functions: [],
+        tableMappings: [],
+        columnMappings: []
+    };
+}

package/dist/chatwms/reports.d.ts

@@ -0,0 +1,66 @@
+import { DataContext } from "./client.js";
+import { DatagridStateBase } from "./datagrid.js";
+export declare const REPORT_VISIBILITY_PRIVATE = "private";
+export declare const REPORT_VISIBILITY_PUBLIC = "public";
+export declare const REPORT_VISIBILITY_GLOBAL = "global";
+export interface ReportParameter {
+    sequence: number;
+    name: string;
+    /** `text` | `number` | `date` | `boolean` */
+    type: string;
+}
+export interface Report {
+    reportId: string;
+    reportTitle: string;
+    reportRoute: string;
+    visibility: string;
+    readonly: boolean;
+    parameters: ReportParameter[];
+    folder: string;
+    brief: string;
+    clientId: string;
+    userId: string;
+}
+export declare function initReport(): Report;
+export interface LineReportParameter {
+    sequence: number;
+    parameterName: string;
+    columnName: string;
+}
+export interface ReportLineContentInfo extends DatagridStateBase {
+    visualizationOption: string;
+    reportParameters: LineReportParameter[];
+    contextName: DataContext;
+    specification: string;
+    query: string;
+    summary: string;
+    reviewOk?: boolean;
+    reviewConfidence?: string;
+    reviewFeedback?: string;
+    tableGroups?: string[];
+    developer?: boolean;
+    archive?: boolean;
+}
+export interface ReportLine {
+    lineId: string;
+    lineTitle: string;
+    reportId: string;
+    contentInfo: ReportLineContentInfo;
+    sequence: number;
+    clientId: string;
+    userId: string;
+}
+export interface ReportLineResult {
+    rows: any[];
+    rowsStr: string;
+    chartRows: any[];
+}
+export declare function initReportLineResult(): ReportLineResult;
+export interface ReportUsage {
+    reportId: string;
+    reportTitle: string;
+    visibility: string;
+    clientId: string;
+    userId: string;
+    datetime: Date;
+}

package/dist/chatwms/reports.js

@@ -0,0 +1,24 @@
+export const REPORT_VISIBILITY_PRIVATE = 'private';
+export const REPORT_VISIBILITY_PUBLIC = 'public';
+export const REPORT_VISIBILITY_GLOBAL = 'global';
+export function initReport() {
+    return {
+        reportId: '',
+        reportTitle: '',
+        reportRoute: '',
+        visibility: REPORT_VISIBILITY_PRIVATE,
+        readonly: false,
+        parameters: [],
+        folder: '',
+        brief: '',
+        clientId: '',
+        userId: ''
+    };
+}
+export function initReportLineResult() {
+    return {
+        rows: [],
+        rowsStr: '',
+        chartRows: []
+    };
+}

package/dist/chatwms/search.d.ts

@@ -0,0 +1,12 @@
+export declare enum SearchRecordType {
+    DASHBOARD = "dashboard",
+    DASHBOARD_WIDGET = "dashboard_widget",
+    DASHBOARD_FOLDER = "dashboard_folder",
+    REPORT = "report",
+    REPORT_LINE = "report_line",
+    REPORT_FOLDER = "report_folder"
+}
+export interface SearchRecord {
+    type: SearchRecordType;
+    data: any;
+}

package/dist/chatwms/search.js

@@ -0,0 +1,9 @@
+export var SearchRecordType;
+(function (SearchRecordType) {
+    SearchRecordType["DASHBOARD"] = "dashboard";
+    SearchRecordType["DASHBOARD_WIDGET"] = "dashboard_widget";
+    SearchRecordType["DASHBOARD_FOLDER"] = "dashboard_folder";
+    SearchRecordType["REPORT"] = "report";
+    SearchRecordType["REPORT_LINE"] = "report_line";
+    SearchRecordType["REPORT_FOLDER"] = "report_folder";
+})(SearchRecordType || (SearchRecordType = {}));

package/dist/util.d.ts

@@ -1,6 +1,11 @@
+export interface KeyValuePair {
+    key: string;
+    value: any;
+}
 export declare function sleep(ms: number): Promise<any>;
-export declare function removeMarkdownIndicators(input: string): string;
-export declare function removePrefixIndicators(input: string, prefixes: string[]): string;
+export declare function reverse(str: string): string;
+export declare function base64Encode(str: string): string;
+export declare function base64Decode(str: string): string;
 export declare function initDate(timeZone?: string): Date;
 export declare function convertDateTimeZone(date: Date, timeZone: string): Date;
 export declare function isDaylightSavingTime(timeZone?: string): boolean;
@@ -10,6 +15,7 @@ export declare function getCurrentDayInMonth(timeZone?: string): number;
 export declare function getDaysInYear(timeZone?: string): 366 | 365;
 export declare function getCurrentMonth(timeZone?: string): number;
 export declare function getCurrentYear(timeZone?: string): number;
+export declare function isDateString(value: any): boolean;
 /**
  * NOTE: `stopIdx` represents last character index of word
  *      ex: ABC -> `startIdx`: 0 `stopIdx`: 2
@@ -26,3 +32,5 @@ export interface QueryRegexMatch {
 export declare function getQueryMatches(query: string, regex: RegExp): QueryRegexMatch[];
 export declare function removeQueryMatches(query: string, matches: QueryRegexMatch[]): string;
 export declare function replaceQueryMatches(query: string, matches: QueryRegexMatch[], replacement: string): string;
+export declare function removeMarkdownIndicators(input: string): string;
+export declare function removePrefixIndicators(input: string, prefixes: string[]): string;

package/dist/util.js

@@ -2,26 +2,14 @@
 export async function sleep(ms) {
     return new Promise(resolve => setTimeout(resolve, ms));
 }
-export function removeMarkdownIndicators(input) {
-    let output = input;
-    // Make sure markdown indicator exists.
-    if (output.includes('```')) {
-        // Remove first markdown indicator.
-        output = output.substring(output.indexOf('```'));
-        output = output.substring(output.indexOf('\n'));
-        // First markdown indicator removed, now do the last.
-        output = output.substring(0, output.indexOf('```')).trim();
-    }
-    return output;
+export function reverse(str) {
+    return str.split('').reverse().join('');
 }
-export function removePrefixIndicators(input, prefixes) {
-    let output = input;
-    for (const prefix of prefixes) {
-        if (output.includes(prefix)) {
-            output = output.substring(output.indexOf(prefix) + prefix.length);
-        }
-    }
-    return output;
+export function base64Encode(str) {
+    return Buffer.from(str, 'utf-8').toString('base64');
+}
+export function base64Decode(str) {
+    return Buffer.from(str, 'base64').toString('utf-8');
 }
 // Dates  --------------------------------------------------------------------------
 export function initDate(timeZone) {
@@ -72,6 +60,41 @@ export function getCurrentYear(timeZone) {
     let date = initDate(timeZone);
     return date.getFullYear();
 }
+export function isDateString(value) {
+    if (typeof value !== 'string')
+        return false;
+    const str = value.trim();
+    /* To be considered a date string, the string:
+        - Must contain at least one digit
+        - Must include a common date separator (e.g. '-', '/', ':', '.', or 'T')
+        - Must not contain any letters other than 'T' or 'Z'
+        - Must successfully parse
+    
+       NOTE: We are not worried about month/day names or AM/PM. If these exist,
+       the user has clearly elected to format the date in the query itself. */
+    if (/[^TZ0-9\s:./-]/i.test(str))
+        return false;
+    /* Handle some edge cases:
+        - If 2 separators, should be at least 6 total characters
+        - Every part separated by '-' or '/' must be 1, 2, or >=4 chars long */
+    if (str.includes('-')) {
+        const dashes = str.split('-');
+        if (dashes.length > 1 && str.length < 6) {
+            return false;
+        }
+    }
+    else if (str.includes('/')) {
+        const slashes = str.split('/');
+        if (slashes.length > 1 && str.length < 6) {
+            return false;
+        }
+    }
+    const sections = str.split(/[-/]+/).filter(Boolean);
+    if (sections.some(s => !(s.length === 1 || s.length === 2 || s.length >= 4))) {
+        return false;
+    }
+    return !isNaN(Date.parse(str));
+}
 /**
  * Will only return matches that **are not** contained in single quotes,
  * double quotes, single line, or multiline comments.
@@ -210,3 +233,25 @@ export function replaceQueryMatches(query, matches, replacement) {
     }
     return adjQuery;
 }
+// LLMs --------------------------------------------------------------------------
+export function removeMarkdownIndicators(input) {
+    let output = input;
+    // Make sure markdown indicator exists.
+    if (output.includes('```')) {
+        // Remove first markdown indicator.
+        output = output.substring(output.indexOf('```'));
+        output = output.substring(output.indexOf('\n'));
+        // First markdown indicator removed, now do the last.
+        output = output.substring(0, output.indexOf('```')).trim();
+    }
+    return output;
+}
+export function removePrefixIndicators(input, prefixes) {
+    let output = input;
+    for (const prefix of prefixes) {
+        if (output.includes(prefix)) {
+            output = output.substring(output.indexOf(prefix) + prefix.length);
+        }
+    }
+    return output;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@cellaware/utils",
-    "version": "7.2.5",
+    "version": "8.0.0",
     "description": "Cellaware Utilities for Node.js",
     "author": "Cellaware Technologies",
     "type": "module",