@cellaware/utils 8.0.1 → 8.0.3

package/dist/llm/cost.js

@@ -1,78 +0,0 @@
-// https://platform.openai.com/docs/pricing
-export function getLLMCostPerToken(modelName) {
-    let inputCost = 0.0;
-    let outputCost = 0.0;
-    switch (modelName) {
-        case 'gpt-5.1':
-            inputCost = 1.25;
-            outputCost = 10.00;
-            break;
-        case 'gpt-5':
-            inputCost = 1.25;
-            outputCost = 10.00;
-            break;
-        case 'gpt-5-mini':
-            inputCost = 0.25;
-            outputCost = 2.00;
-            break;
-        case 'gpt-5-nano':
-            inputCost = 0.05;
-            outputCost = 0.40;
-            break;
-        case 'gpt-4.1':
-            inputCost = 2.00;
-            outputCost = 8.00;
-            break;
-        case 'gpt-4.1-mini':
-            inputCost = 0.40;
-            outputCost = 1.60;
-            break;
-        case 'gpt-4.1-nano':
-            inputCost = 0.10;
-            outputCost = 0.40;
-            break;
-        case 'gpt-4o':
-            inputCost = 2.50;
-            outputCost = 10.00;
-            break;
-        case 'gpt-4o-mini':
-            inputCost = 0.15;
-            outputCost = 0.60;
-            break;
-        case 'o1':
-            inputCost = 15.00;
-            outputCost = 60.00;
-            break;
-        case 'o1-mini':
-            inputCost = 1.10;
-            outputCost = 4.40;
-            break;
-        case 'o3':
-            inputCost = 10.00;
-            outputCost = 40.00;
-            break;
-        case 'o3-mini':
-            inputCost = 1.10;
-            outputCost = 4.40;
-            break;
-        case 'o4-mini':
-            inputCost = 1.10;
-            outputCost = 4.40;
-            break;
-        default:
-            throw new Error(`Model '${modelName}' cost is not configured`);
-    }
-    // OpenAI model costs are measured in millions of tokens -- therefore we need to divide each figure by 1,000,000 before returning.
-    const unit = 1_000_000.0;
-    inputCost /= unit;
-    outputCost /= unit;
-    return { inputCost, outputCost };
-}
-export function getLLMTransactionCost(tokenUsage, modelName) {
-    let cost = 0.0;
-    if (!!tokenUsage) {
-        const { inputCost, outputCost } = getLLMCostPerToken(modelName);
-        cost = (tokenUsage.promptTokens * inputCost) + (tokenUsage.completionTokens * outputCost);
-    }
-    return cost;
-}

package/dist/llm/model.d.ts

@@ -1,12 +0,0 @@
-export type ModelName = 'gpt-5.1' | 'gpt-5' | 'gpt-5-mini' | 'gpt-5-nano' | 'gpt-4.1' | 'gpt-4.1-mini' | 'gpt-4.1-nano' | 'gpt-4o' | 'gpt-4o-mini' | 'o1' | 'o1-mini' | 'o3' | 'o3-mini' | 'o4-mini';
-export type ReasoningEffort = 'minimal' | 'low' | 'medium' | 'high';
-export type Verbosity = 'low' | 'medium' | 'high';
-export interface OpenAIModelOptions {
-    reasoning_effort?: ReasoningEffort;
-    verbosity?: Verbosity;
-}
-export interface ModelOptions {
-    modelName: string;
-    temperature?: number;
-    openai?: OpenAIModelOptions;
-}

package/dist/llm/model.js

@@ -1 +0,0 @@
-export {};

package/dist/stopwatch.d.ts

@@ -1,8 +0,0 @@
-export declare class Stopwatch {
-    private startTime?;
-    private elapsed;
-    start(): void;
-    stop(): void;
-    reset(): void;
-    getElapsedMs(): number;
-}

package/dist/stopwatch.js

@@ -1,36 +0,0 @@
-export class Stopwatch {
-    constructor() {
-        Object.defineProperty(this, "startTime", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "elapsed", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: 0n
-        });
-    }
-    start() {
-        if (!this.startTime) {
-            this.startTime = process.hrtime.bigint();
-        }
-    }
-    stop() {
-        if (!!this.startTime) {
-            this.elapsed += process.hrtime.bigint() - this.startTime;
-            this.startTime = undefined;
-        }
-    }
-    reset() {
-        this.elapsed = 0n;
-        this.startTime = undefined;
-    }
-    getElapsedMs() {
-        const now = this.startTime ? process.hrtime.bigint() : 0n;
-        const total = this.elapsed + (this.startTime ? now - this.startTime : 0n);
-        return Number(total) / 1e6;
-    }
-}

package/dist/util.d.ts

@@ -1,36 +0,0 @@
-export interface KeyValuePair {
-    key: string;
-    value: any;
-}
-export declare function sleep(ms: number): Promise<any>;
-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;
-export declare function isLeapYear(timeZone?: string): boolean;
-export declare function getDaysInMonth(timeZone?: string): number;
-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
- */
-export interface QueryRegexMatch {
-    word: string;
-    startIdx: number;
-    stopIdx: number;
-}
-/**
- * Will only return matches that **are not** contained in single quotes,
- * double quotes, single line, or multiline comments.
- */
-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

@@ -1,257 +0,0 @@
-// Miscellaneous  --------------------------------------------------------------------------
-export async function sleep(ms) {
-    return new Promise(resolve => setTimeout(resolve, ms));
-}
-export function reverse(str) {
-    return str.split('').reverse().join('');
-}
-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) {
-    const date = new Date();
-    if (!!timeZone) {
-        return new Date(date.toLocaleString('en-US', { timeZone }));
-    }
-    else {
-        return date;
-    }
-}
-export function convertDateTimeZone(date, timeZone) {
-    if (!!timeZone) {
-        return new Date(date.toLocaleString('en-US', { timeZone }));
-    }
-    else {
-        return date;
-    }
-}
-export function isDaylightSavingTime(timeZone) {
-    const date = initDate(timeZone);
-    const jan = new Date(date.getFullYear(), 0, 1);
-    const jul = new Date(date.getFullYear(), 6, 1);
-    return date.getTimezoneOffset() < Math.max(jan.getTimezoneOffset(), jul.getTimezoneOffset());
-}
-export function isLeapYear(timeZone) {
-    let year = initDate(timeZone).getFullYear();
-    return ((year % 4 == 0) && (year % 100 != 0)) || (year % 400 == 0);
-}
-export function getDaysInMonth(timeZone) {
-    let date = initDate(timeZone);
-    // NOTE: month is 0-based.
-    return new Date(date.getFullYear(), date.getMonth() + 1, 0).getDate();
-}
-export function getCurrentDayInMonth(timeZone) {
-    let date = initDate(timeZone);
-    return date.getDate();
-}
-export function getDaysInYear(timeZone) {
-    return isLeapYear(timeZone) ? 366 : 365;
-}
-export function getCurrentMonth(timeZone) {
-    let date = initDate(timeZone);
-    // NOTE: month is 0-based.
-    return date.getMonth() + 1;
-}
-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.
- */
-export function getQueryMatches(query, regex) {
-    let matches = [];
-    // Find quote ranges first.
-    let singleQuoteRanges = [];
-    {
-        let open = false;
-        let startIdx = -1;
-        for (let i = 0; i < query.length; i++) {
-            if (query[i] === "'") {
-                if (open) {
-                    singleQuoteRanges.push({ startIdx, stopIdx: i });
-                }
-                else {
-                    startIdx = i;
-                }
-                open = !open;
-            }
-        }
-    }
-    let doubleQuoteRanges = [];
-    {
-        let open = false;
-        let startIdx = -1;
-        for (let i = 0; i < query.length; i++) {
-            if (query[i] === '"') {
-                if (open) {
-                    doubleQuoteRanges.push({ startIdx, stopIdx: i });
-                }
-                else {
-                    startIdx = i;
-                }
-                open = !open;
-            }
-        }
-    }
-    let singleLineCommentRanges = [];
-    {
-        let open = false;
-        let startIdx = -1;
-        for (let i = 0; i < query.length; i++) {
-            if (!open && query[i] === '-' && (i < query.length - 1 && query[i + 1] === '-')) {
-                open = true;
-                startIdx = i;
-            }
-            else if (open && (query[i] === '\n' || query[i] === '\r')) {
-                open = false;
-                singleLineCommentRanges.push({ startIdx, stopIdx: i });
-            }
-        }
-    }
-    let multilineCommentRanges = [];
-    {
-        let open = false;
-        let startIdx = -1;
-        for (let i = 0; i < query.length; i++) {
-            if (!open && query[i] === '/' && (i < query.length - 1 && query[i + 1] === '*')) {
-                open = true;
-                startIdx = i;
-            }
-            else if (open && query[i] === '/' && (i > 0 && query[i - 1] === '*')) {
-                open = false;
-                multilineCommentRanges.push({ startIdx, stopIdx: i });
-            }
-        }
-    }
-    // Now find matches and filter out the ones that are contained in quotes.
-    {
-        let match;
-        while ((match = regex.exec(query)) != null) {
-            let startIdx = match.index;
-            let stopIdx = match.index + match[0].length - 1;
-            let contained = false;
-            for (const quoteRange of singleQuoteRanges) {
-                if (quoteRange.startIdx <= startIdx && quoteRange.stopIdx >= stopIdx) {
-                    contained = true;
-                    break;
-                }
-            }
-            if (!contained) {
-                for (const quoteRange of doubleQuoteRanges) {
-                    if (quoteRange.startIdx <= startIdx && quoteRange.stopIdx >= stopIdx) {
-                        contained = true;
-                        break;
-                    }
-                }
-            }
-            if (!contained) {
-                for (const singleLineCommentRange of singleLineCommentRanges) {
-                    if (singleLineCommentRange.startIdx <= startIdx && singleLineCommentRange.stopIdx >= stopIdx) {
-                        contained = true;
-                        break;
-                    }
-                }
-            }
-            if (!contained) {
-                for (const multilineCommentRange of multilineCommentRanges) {
-                    if (multilineCommentRange.startIdx <= startIdx && multilineCommentRange.stopIdx >= stopIdx) {
-                        contained = true;
-                        break;
-                    }
-                }
-            }
-            if (!contained) {
-                matches.push({ word: match[0], startIdx, stopIdx });
-            }
-        }
-    }
-    return matches;
-}
-export function removeQueryMatches(query, matches) {
-    let adjQuery = query;
-    let offset = 0;
-    for (const match of matches) {
-        const start = match.startIdx - offset;
-        const stop = match.stopIdx + 1 - offset;
-        adjQuery = adjQuery.substring(0, start) + adjQuery.substring(stop);
-        offset += match.word.length;
-    }
-    return adjQuery;
-}
-export function replaceQueryMatches(query, matches, replacement) {
-    let adjQuery = query;
-    let offset = 0;
-    for (const match of matches) {
-        const start = match.startIdx - offset;
-        const stop = match.stopIdx + 1 - offset;
-        adjQuery =
-            adjQuery.substring(0, start) +
-                replacement +
-                adjQuery.substring(stop);
-        offset += (match.word.length - replacement.length);
-    }
-    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/dist/version.d.ts

@@ -1,4 +0,0 @@
-/**
- * Extracts `version` from `package.json`.
- */
-export declare function getVersion(): string;

package/dist/version.js

@@ -1,12 +0,0 @@
-import fs from 'fs';
-/**
- * Extracts `version` from `package.json`.
- */
-export function getVersion() {
-    const path = 'package.json';
-    if (!fs.existsSync(path)) {
-        throw new Error(`VERSION: '${path}' not found`);
-    }
-    const content = JSON.parse(fs.readFileSync(path, 'utf8'));
-    return content.version ?? '';
-}