tjbot-ce 3.0.1

package/dist/utils/colors.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Copyright 2026-present TJBot Contributors. All Rights Reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Get the list of all colors recognized by TJBot.
+ * @return {string[]} List of all named colors recognized by `shine()` and `pulse()`.
+ * @public
+ */
+export declare function getShineColors(): string[];
+/**
+ * Convert hex color to RGB value.
+ * @param {string} hexColor Hex color (e.g. FF8888)
+ * @return {array} RGB color (e.g. (255, 128, 128))
+ * @private
+ */
+export declare function convertHexToRgbColor(hexColor: string): [number, number, number];
+/**
+ * Normalize the given color to #RRGGBB.
+ * @param {string} color The color to shine the LED. May be specified in a number of
+ * formats, including: hexadecimal, (e.g. "0xF12AC4", "11FF22", "#AABB24"), "on", "off",
+ * or may be a named color from TJBot's curated LED color list. Hexadecimal colors
+ * follow an #RRGGBB format.
+ * @return {string} Hex string corresponding to the given color (e.g. "#RRGGBB")
+ * @private
+ */
+export declare function normalizeColor(color: string): string;
+//# sourceMappingURL=colors.d.ts.map

package/dist/utils/colors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"colors.d.ts","sourceRoot":"","sources":["../../src/utils/colors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AA2DH;;;;GAIG;AACH,wBAAgB,cAAc,IAAI,MAAM,EAAE,CAGzC;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAgB/E;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CA6DpD"}

package/dist/utils/colors.js

@@ -0,0 +1,155 @@
+/**
+ * Copyright 2026-present TJBot Contributors. All Rights Reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { readFileSync } from 'fs';
+import yaml from 'js-yaml';
+import { dirname, join } from 'path';
+import { fileURLToPath } from 'url';
+import { TJBotError } from './errors.js';
+import { getLogger } from './logging.js';
+const logger = getLogger(import.meta.url);
+const DIRNAME = dirname(fileURLToPath(import.meta.url));
+/**
+ * Color map: normalized color name (lowercase, no spaces) -> hex value
+ * @private
+ */
+const colorMap = new Map();
+/**
+ * Original color names (for getShineColors())
+ * @private
+ */
+const colorNames = [];
+let colorsLoaded = false;
+/**
+ * Load colors from YAML file
+ * @private
+ */
+function loadColors() {
+    try {
+        const colorsPath = join(DIRNAME, '../config/vendor/colors.yaml');
+        const colorsYaml = readFileSync(colorsPath, 'utf8');
+        const colors = yaml.load(colorsYaml);
+        for (const [name, hex] of Object.entries(colors)) {
+            // Store original name for listing
+            colorNames.push(name);
+            // Normalize: remove all whitespace and convert to lowercase
+            const normalizedName = name.replace(/\s+/g, '').toLowerCase();
+            colorMap.set(normalizedName, hex);
+        }
+        logger.debug(`loaded ${colorNames.length} colors for LED control`);
+    }
+    catch (error) {
+        logger.error('Failed to load colors.yaml:', error);
+        throw new TJBotError('Failed to load LED color definitions');
+    }
+}
+function ensureColorsLoaded() {
+    if (!colorsLoaded) {
+        loadColors();
+        colorsLoaded = true;
+    }
+}
+/**
+ * Get the list of all colors recognized by TJBot.
+ * @return {string[]} List of all named colors recognized by `shine()` and `pulse()`.
+ * @public
+ */
+export function getShineColors() {
+    ensureColorsLoaded();
+    return [...colorNames];
+}
+/**
+ * Convert hex color to RGB value.
+ * @param {string} hexColor Hex color (e.g. FF8888)
+ * @return {array} RGB color (e.g. (255, 128, 128))
+ * @private
+ */
+export function convertHexToRgbColor(hexColor) {
+    const rgbHex = hexColor
+        .replace(/^#?([a-f\d])([a-f\d])([a-f\d])$/i, (_m, r, g, b) => `#${r}${r}${g}${g}${b}${b}`)
+        .substring(1)
+        .match(/.{2}/g);
+    if (rgbHex !== null) {
+        const rgb = rgbHex.map((x) => parseInt(x, 16));
+        return [rgb[0], rgb[1], rgb[2]];
+    }
+    else {
+        logger.warn(`An error occurred converting hex color ${hexColor} to RGB, returning [0, 0, 0]`);
+        return [0, 0, 0];
+    }
+}
+/**
+ * Normalize the given color to #RRGGBB.
+ * @param {string} color The color to shine the LED. May be specified in a number of
+ * formats, including: hexadecimal, (e.g. "0xF12AC4", "11FF22", "#AABB24"), "on", "off",
+ * or may be a named color from TJBot's curated LED color list. Hexadecimal colors
+ * follow an #RRGGBB format.
+ * @return {string} Hex string corresponding to the given color (e.g. "#RRGGBB")
+ * @private
+ */
+export function normalizeColor(color) {
+    ensureColorsLoaded();
+    let normColor = color;
+    // assume undefined == "off"
+    if (normColor === undefined) {
+        normColor = 'off';
+    }
+    // strip prefixes if they are present
+    if (normColor.startsWith('0x')) {
+        normColor = normColor.slice(2);
+    }
+    if (normColor.startsWith('#')) {
+        normColor = normColor.slice(1);
+    }
+    // is this a hex number or a named color?
+    const isHex = /(^[0-9A-F]{6}$)|(^[0-9A-F]{3}$)/i;
+    let rgb;
+    if (!isHex.test(normColor)) {
+        // Look up named color in our curated color map
+        const normalizedName = normColor.replace(/\s+/g, '').toLowerCase();
+        const hexValue = colorMap.get(normalizedName);
+        if (hexValue) {
+            rgb = hexValue;
+        }
+        else {
+            rgb = undefined;
+        }
+    }
+    else {
+        rgb = normColor;
+    }
+    // Expand CSS-style short hex (#abc → #aabbcc)
+    if (rgb !== undefined && rgb.replace(/^#/, '').length === 3) {
+        rgb = rgb
+            .replace(/^#/, '')
+            .split('')
+            .map((ch) => ch + ch)
+            .join('');
+    }
+    // did we get something back?
+    if (rgb === undefined) {
+        throw new TJBotError(`TJBot did not understand the specified color "${color}"`);
+    }
+    // prefix rgb with # in case it's not
+    if (!rgb.startsWith('#')) {
+        rgb = `#${rgb}`;
+    }
+    // throw an error if we didn't understand this color
+    if (rgb.length !== 7) {
+        throw new TJBotError(`TJBot did not understand the specified color "${color}"`);
+    }
+    return rgb;
+}
+//# sourceMappingURL=colors.js.map

package/dist/utils/colors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"colors.js","sourceRoot":"","sources":["../../src/utils/colors.ts"],"names":[],"mappings":"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"}

package/dist/utils/constants.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Copyright 2025 IBM Corp. All Rights Reserved.
+ * Copyright 2026-present TJBot Contributors. All Rights Reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * TJBot capabilities
+ * @readonly
+ * @enum {string}
+ */
+export declare enum Capability {
+    LISTEN = "listen",
+    SEE = "see",
+    SHINE = "shine",
+    SPEAK = "speak",
+    WAVE = "wave"
+}
+/**
+ * TJBot hardware
+ * @readonly
+ * @enum {string}
+ */
+export declare enum Hardware {
+    CAMERA = "camera",
+    LED = "led",
+    MICROPHONE = "microphone",
+    SERVO = "servo",
+    SPEAKER = "speaker"
+}
+//# sourceMappingURL=constants.d.ts.map

package/dist/utils/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/utils/constants.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH;;;;GAIG;AACH,oBAAY,UAAU;IAClB,MAAM,WAAW;IACjB,GAAG,QAAQ;IACX,KAAK,UAAU;IACf,KAAK,UAAU;IACf,IAAI,SAAS;CAChB;AAED;;;;GAIG;AACH,oBAAY,QAAQ;IAChB,MAAM,WAAW;IACjB,GAAG,QAAQ;IACX,UAAU,eAAe;IACzB,KAAK,UAAU;IACf,OAAO,YAAY;CACtB"}

package/dist/utils/constants.js

@@ -0,0 +1,43 @@
+/**
+ * Copyright 2025 IBM Corp. All Rights Reserved.
+ * Copyright 2026-present TJBot Contributors. All Rights Reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * TJBot capabilities
+ * @readonly
+ * @enum {string}
+ */
+export var Capability;
+(function (Capability) {
+    Capability["LISTEN"] = "listen";
+    Capability["SEE"] = "see";
+    Capability["SHINE"] = "shine";
+    Capability["SPEAK"] = "speak";
+    Capability["WAVE"] = "wave";
+})(Capability || (Capability = {}));
+/**
+ * TJBot hardware
+ * @readonly
+ * @enum {string}
+ */
+export var Hardware;
+(function (Hardware) {
+    Hardware["CAMERA"] = "camera";
+    Hardware["LED"] = "led";
+    Hardware["MICROPHONE"] = "microphone";
+    Hardware["SERVO"] = "servo";
+    Hardware["SPEAKER"] = "speaker";
+})(Hardware || (Hardware = {}));
+//# sourceMappingURL=constants.js.map

package/dist/utils/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/utils/constants.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH;;;;GAIG;AACH,MAAM,CAAN,IAAY,UAMX;AAND,WAAY,UAAU;IAClB,+BAAiB,CAAA;IACjB,yBAAW,CAAA;IACX,6BAAe,CAAA;IACf,6BAAe,CAAA;IACf,2BAAa,CAAA;AACjB,CAAC,EANW,UAAU,KAAV,UAAU,QAMrB;AAED;;;;GAIG;AACH,MAAM,CAAN,IAAY,QAMX;AAND,WAAY,QAAQ;IAChB,6BAAiB,CAAA;IACjB,uBAAW,CAAA;IACX,qCAAyB,CAAA;IACzB,2BAAe,CAAA;IACf,+BAAmB,CAAA;AACvB,CAAC,EANW,QAAQ,KAAR,QAAQ,QAMnB"}

package/dist/utils/credentials.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Copyright 2026-present TJBot Contributors. All Rights Reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+export interface AzureCredentials {
+    speechKey?: string;
+    speechRegion?: string;
+    visionKey?: string;
+    visionEndpoint?: string;
+}
+/**
+ * Resolves a credentials file path by checking provided path, then CWD, then ~/.tjbot.
+ * @param filename - The filename to look for (e.g., 'azure-credentials.env')
+ * @param providedPath - Optional explicit path to check first
+ * @throws {TJBotError} if no credentials file is found
+ */
+export declare function resolveCredentialsPath(filename: string, providedPath?: string): string;
+/**
+ * Resolves, loads, and exports Azure credentials.
+ */
+export declare function loadAzureCredentials(providedPath?: string): AzureCredentials;
+/**
+ * Resolves Google Cloud credentials and exports credentials path for ADC.
+ */
+export declare function loadGoogleCloudCredentials(providedPath?: string): {
+    credentialsPath: string;
+};
+/**
+ * Resolves, loads, and exports IBM Watson credentials.
+ */
+export declare function loadIBMWatsonCloudCredentials(providedPath?: string): void;
+//# sourceMappingURL=credentials.d.ts.map

package/dist/utils/credentials.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"credentials.d.ts","sourceRoot":"","sources":["../../src/utils/credentials.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAUH,MAAM,WAAW,gBAAgB;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAqBtF;AAiCD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAkB5E;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG;IAAE,eAAe,EAAE,MAAM,CAAA;CAAE,CAW7F;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CASzE"}

package/dist/utils/credentials.js

@@ -0,0 +1,121 @@
+/**
+ * Copyright 2026-present TJBot Contributors. All Rights Reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import fs from 'fs';
+import os from 'os';
+import path from 'path';
+import { TJBotError } from './errors.js';
+import { getLogger } from './logging.js';
+const logger = getLogger(import.meta.url);
+/**
+ * Resolves a credentials file path by checking provided path, then CWD, then ~/.tjbot.
+ * @param filename - The filename to look for (e.g., 'azure-credentials.env')
+ * @param providedPath - Optional explicit path to check first
+ * @throws {TJBotError} if no credentials file is found
+ */
+export function resolveCredentialsPath(filename, providedPath) {
+    if (providedPath) {
+        logger.verbose(`Using specified path for credentials: ${providedPath}`);
+        if (!fs.existsSync(providedPath)) {
+            throw new TJBotError(`Credentials file not found at: ${providedPath}`);
+        }
+        return providedPath;
+    }
+    const defaultPaths = [path.join(process.cwd(), filename), path.join(os.homedir(), '.tjbot', filename)];
+    for (const defaultPath of defaultPaths) {
+        if (fs.existsSync(defaultPath)) {
+            logger.verbose(`Found credentials file at: ${defaultPath}`);
+            return defaultPath;
+        }
+    }
+    throw new TJBotError(`Credentials file ${filename} not found. Place credentials at: ./${filename} or ~/.tjbot/${filename}`);
+}
+/**
+ * Parses a .env format credentials file into key-value pairs.
+ */
+function parseEnvCredentialsFile(credentialsPath) {
+    const raw = {};
+    fs.readFileSync(credentialsPath, 'utf-8')
+        .split('\n')
+        .forEach((line) => {
+        line = line.trim();
+        if (line && !line.startsWith('#')) {
+            const [key, ...valueParts] = line.split('=');
+            if (key) {
+                raw[key.trim()] = valueParts.join('=').trim();
+            }
+        }
+    });
+    logger.debug(`Parsed ${Object.keys(raw).length} credentials from file: ${credentialsPath}`);
+    return raw;
+}
+/**
+ * Loads credentials into environment variables.
+ * @param credentials - A record of key-value pairs representing credentials
+ */
+function loadCredentialsIntoEnvironment(credentials) {
+    Object.entries(credentials).forEach(([key, value]) => {
+        process.env[key] = value;
+        logger.debug(`loaded credential into environment: ${key}=***`);
+    });
+}
+/**
+ * Resolves, loads, and exports Azure credentials.
+ */
+export function loadAzureCredentials(providedPath) {
+    const credentialsPath = resolveCredentialsPath('azure-credentials.env', providedPath);
+    logger.verbose(`Loading Azure credentials from file: ${credentialsPath}`);
+    try {
+        const raw = parseEnvCredentialsFile(credentialsPath);
+        loadCredentialsIntoEnvironment(raw);
+        logger.debug(`Loaded Azure credentials from: ${credentialsPath}`);
+        return {
+            speechKey: raw.AZURE_SPEECH_KEY,
+            speechRegion: raw.AZURE_SPEECH_REGION,
+            visionKey: raw.AZURE_VISION_KEY,
+            visionEndpoint: raw.AZURE_VISION_ENDPOINT,
+        };
+    }
+    catch (err) {
+        throw new TJBotError(`Failed to load Azure credentials from ${credentialsPath}`, { cause: err });
+    }
+}
+/**
+ * Resolves Google Cloud credentials and exports credentials path for ADC.
+ */
+export function loadGoogleCloudCredentials(providedPath) {
+    const credentialsPath = resolveCredentialsPath('google-credentials.json', providedPath);
+    logger.verbose(`Loading Google Cloud credentials from file: ${credentialsPath}`);
+    if (!fs.existsSync(credentialsPath)) {
+        throw new TJBotError(`Google Cloud credentials file not found at: ${credentialsPath}`);
+    }
+    loadCredentialsIntoEnvironment({ GOOGLE_APPLICATION_CREDENTIALS: credentialsPath });
+    return { credentialsPath };
+}
+/**
+ * Resolves, loads, and exports IBM Watson credentials.
+ */
+export function loadIBMWatsonCloudCredentials(providedPath) {
+    const credentialsPath = resolveCredentialsPath('ibm-credentials.env', providedPath);
+    logger.verbose(`Loading IBM Watson credentials from file: ${credentialsPath}`);
+    try {
+        const raw = parseEnvCredentialsFile(credentialsPath);
+        loadCredentialsIntoEnvironment(raw);
+    }
+    catch (err) {
+        throw new TJBotError(`Failed to load IBM Watson credentials from ${credentialsPath}`, { cause: err });
+    }
+}
+//# sourceMappingURL=credentials.js.map

package/dist/utils/credentials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"credentials.js","sourceRoot":"","sources":["../../src/utils/credentials.ts"],"names":[],"mappings":"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"}

package/dist/utils/errors.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Copyright 2026-present TJBot Contributors. All Rights Reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+export declare class TJBotError extends Error {
+    readonly code?: string;
+    readonly context?: Record<string, unknown>;
+    readonly cause?: Error;
+    constructor(message: string, options?: {
+        code?: string;
+        context?: Record<string, unknown>;
+        cause?: Error;
+    });
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/utils/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,qBAAa,UAAW,SAAQ,KAAK;IACjC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3C,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC;gBAEX,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAAC,KAAK,CAAC,EAAE,KAAK,CAAA;KAAE;CAY7G"}

package/dist/utils/errors.js

@@ -0,0 +1,32 @@
+/**
+ * Copyright 2026-present TJBot Contributors. All Rights Reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+export class TJBotError extends Error {
+    code;
+    context;
+    cause;
+    constructor(message, options) {
+        super(message);
+        this.name = 'TJBotError';
+        this.code = options?.code;
+        this.context = options?.context;
+        this.cause = options?.cause;
+        // Maintain proper stack trace for where our error was thrown (only available on V8)
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, TJBotError);
+        }
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/utils/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,MAAM,OAAO,UAAW,SAAQ,KAAK;IACxB,IAAI,CAAU;IACd,OAAO,CAA2B;IAClC,KAAK,CAAS;IAEvB,YAAY,OAAe,EAAE,OAA6E;QACtG,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;QACzB,IAAI,CAAC,IAAI,GAAG,OAAO,EAAE,IAAI,CAAC;QAC1B,IAAI,CAAC,OAAO,GAAG,OAAO,EAAE,OAAO,CAAC;QAChC,IAAI,CAAC,KAAK,GAAG,OAAO,EAAE,KAAK,CAAC;QAE5B,oFAAoF;QACpF,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;YAC1B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QAC9C,CAAC;IACL,CAAC;CACJ"}

package/dist/utils/index.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Copyright 2025 IBM Corp. All Rights Reserved.
+ * Copyright 2026-present TJBot Contributors. All Rights Reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+export { convertHexToRgbColor, getShineColors, normalizeColor } from './colors.js';
+export { Capability, Hardware } from './constants.js';
+export { TJBotError } from './errors.js';
+export { getLogger, initWinston } from './logging.js';
+export type { TJBotLogLevel } from './logging.js';
+export { ModelRegistry } from './model-registry.js';
+export type { BaseModelMetadata, ModelType, STTModelMetadata, TTSModelMetadata, VADModelMetadata, VisionModelMetadata, } from './model-registry.js';
+export { isCommandAvailable, sleep, sleepSync } from './utils.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACnF,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AACtD,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,YAAY,EACR,iBAAiB,EACjB,SAAS,EACT,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,GACtB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,kBAAkB,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,23 @@
+/**
+ * Copyright 2025 IBM Corp. All Rights Reserved.
+ * Copyright 2026-present TJBot Contributors. All Rights Reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+export { convertHexToRgbColor, getShineColors, normalizeColor } from './colors.js';
+export { Capability, Hardware } from './constants.js';
+export { TJBotError } from './errors.js';
+export { getLogger, initWinston } from './logging.js';
+export { ModelRegistry } from './model-registry.js';
+export { isCommandAvailable, sleep, sleepSync } from './utils.js';
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACnF,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEtD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AASpD,OAAO,EAAE,kBAAkB,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC"}

package/dist/utils/logging.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Copyright 2026-present TJBot Contributors. All Rights Reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import winston from 'winston';
+export type TJBotLogLevel = 'error' | 'warn' | 'info' | 'verbose' | 'debug';
+export declare enum LogEmoji {
+    CAMERA = "\uD83D\uDCF7",
+    COLOR = "\uD83C\uDFA8",
+    CONFIG = "\u2699\uFE0F",
+    GENERAL = "\uD83E\uDD16",
+    HARDWARE = "\uD83D\uDD27",
+    LED = "\uD83D\uDCA1",
+    MIC = "\uD83C\uDFA4",
+    MODEL = "\uD83D\uDCE6",
+    RPI = "\uD83C\uDF53",
+    SERVO = "\uD83E\uDDBE",
+    SPEAKER = "\uD83D\uDD08",
+    STT = "\uD83E\uDDBB",
+    TTS = "\uD83D\uDCAC",
+    VISION = "\uD83D\uDC41\uFE0F"
+}
+/**
+ * Initialize Winston with TJBot's default formatter.
+ * Safe to call repeatedly; only the first call configures transports/format.
+ * Later calls only update log level.
+ */
+export declare function initWinston(level?: TJBotLogLevel): void;
+/**
+ * Get a module-scoped logger that lets the formatter infer a category emoji.
+ */
+export declare function getLogger(moduleName: string): winston.Logger;
+//# sourceMappingURL=logging.d.ts.map

package/dist/utils/logging.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging.d.ts","sourceRoot":"","sources":["../../src/utils/logging.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,OAAO,MAAM,SAAS,CAAC;AAG9B,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;AAE5E,oBAAY,QAAQ;IAChB,MAAM,iBAAO;IACb,KAAK,iBAAO;IACZ,MAAM,iBAAO;IACb,OAAO,iBAAO;IACd,QAAQ,iBAAO;IACf,GAAG,iBAAO;IACV,GAAG,iBAAO;IACV,KAAK,iBAAO;IACZ,GAAG,iBAAO;IACV,KAAK,iBAAO;IACZ,OAAO,iBAAO;IACd,GAAG,iBAAO;IACV,GAAG,iBAAO;IACV,MAAM,uBAAQ;CACjB;AAyED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,GAAE,aAAsB,GAAG,IAAI,CAY/D;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAE5D"}