@mentra/sdk 2.1.26 → 2.1.28

package/dist/types/models.js

@@ -1,101 +0,0 @@
-"use strict";
-// @mentra/sdk
-// packages/sdk/types/src/models.ts - Core models
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.LEGACY_PERMISSION_MAP = exports.PermissionType = void 0;
-exports.validateAppConfig = validateAppConfig;
-const enums_1 = require("./enums");
-// Define PermissionType enum with legacy support
-var PermissionType;
-(function (PermissionType) {
-    PermissionType["MICROPHONE"] = "MICROPHONE";
-    PermissionType["LOCATION"] = "LOCATION";
-    PermissionType["BACKGROUND_LOCATION"] = "BACKGROUND_LOCATION";
-    PermissionType["CALENDAR"] = "CALENDAR";
-    PermissionType["CAMERA"] = "CAMERA";
-    // Legacy notification permission (backward compatibility)
-    PermissionType["NOTIFICATIONS"] = "NOTIFICATIONS";
-    // New granular notification permissions
-    PermissionType["READ_NOTIFICATIONS"] = "READ_NOTIFICATIONS";
-    PermissionType["POST_NOTIFICATIONS"] = "POST_NOTIFICATIONS";
-    PermissionType["ALL"] = "ALL";
-})(PermissionType || (exports.PermissionType = PermissionType = {}));
-// Legacy permission mapping for backward compatibility
-exports.LEGACY_PERMISSION_MAP = new Map([
-    [PermissionType.NOTIFICATIONS, [PermissionType.READ_NOTIFICATIONS]],
-]);
-/**
- * Validate a App configuration object
- * @param config Object to validate
- * @returns True if the config is valid
- */
-function validateAppConfig(config) {
-    if (!config || typeof config !== "object")
-        return false;
-    // Check required string properties
-    if (typeof config.name !== "string" ||
-        typeof config.description !== "string" ||
-        typeof config.version !== "string") {
-        return false;
-    }
-    // Check settings array
-    if (!Array.isArray(config.settings))
-        return false;
-    // Validate each setting
-    return config.settings.every((setting) => {
-        // Group settings just need a title
-        if (setting.type === "group") {
-            return typeof setting.title === "string";
-        }
-        // TITLE_VALUE settings just need label and value
-        if (setting.type === "titleValue") {
-            return typeof setting.label === "string" && "value" in setting;
-        }
-        // Regular settings need key and label
-        if (typeof setting.key !== "string" || typeof setting.label !== "string") {
-            return false;
-        }
-        // Type-specific validation
-        switch (setting.type) {
-            case enums_1.AppSettingType.TOGGLE:
-                return typeof setting.defaultValue === "boolean";
-            case enums_1.AppSettingType.TEXT:
-            case enums_1.AppSettingType.TEXT_NO_SAVE_BUTTON:
-                return (setting.defaultValue === undefined ||
-                    typeof setting.defaultValue === "string");
-            case enums_1.AppSettingType.SELECT:
-            case enums_1.AppSettingType.SELECT_WITH_SEARCH:
-                return (Array.isArray(setting.options) &&
-                    setting.options.every((opt) => typeof opt.label === "string" && "value" in opt));
-            case enums_1.AppSettingType.MULTISELECT:
-                return (Array.isArray(setting.options) &&
-                    setting.options.every((opt) => typeof opt.label === "string" && "value" in opt) &&
-                    (setting.defaultValue === undefined ||
-                        Array.isArray(setting.defaultValue)));
-            case enums_1.AppSettingType.SLIDER:
-                return (typeof setting.defaultValue === "number" &&
-                    typeof setting.min === "number" &&
-                    typeof setting.max === "number" &&
-                    setting.min <= setting.max);
-            case enums_1.AppSettingType.NUMERIC_INPUT:
-                return ((setting.defaultValue === undefined ||
-                    typeof setting.defaultValue === "number") &&
-                    (setting.min === undefined || typeof setting.min === "number") &&
-                    (setting.max === undefined || typeof setting.max === "number") &&
-                    (setting.step === undefined || typeof setting.step === "number") &&
-                    (setting.placeholder === undefined ||
-                        typeof setting.placeholder === "string"));
-            case enums_1.AppSettingType.TIME_PICKER:
-                return ((setting.defaultValue === undefined ||
-                    typeof setting.defaultValue === "number") &&
-                    (setting.showSeconds === undefined ||
-                        typeof setting.showSeconds === "boolean"));
-            case enums_1.AppSettingType.GROUP:
-                return typeof setting.title === "string";
-            case enums_1.AppSettingType.TITLE_VALUE:
-                return typeof setting.label === "string" && "value" in setting;
-            default:
-                return false;
-        }
-    });
-}

package/dist/types/photo-data.js

@@ -1,2 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/rtmp-stream.js

@@ -1,3 +0,0 @@
-"use strict";
-// src/types/rtmp-stream.ts
-Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/streams.js

@@ -1,306 +0,0 @@
-"use strict";
-// src/streams.ts
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.STREAM_CATEGORIES = exports.StreamCategory = exports.StreamType = void 0;
-exports.isValidLanguageCode = isValidLanguageCode;
-exports.parseLanguageStream = parseLanguageStream;
-exports.createTranscriptionStream = createTranscriptionStream;
-exports.createTranslationStream = createTranslationStream;
-exports.isValidStreamType = isValidStreamType;
-exports.isStreamCategory = isStreamCategory;
-exports.getStreamTypesByCategory = getStreamTypesByCategory;
-exports.getBaseStreamType = getBaseStreamType;
-exports.isLanguageStream = isLanguageStream;
-exports.getLanguageInfo = getLanguageInfo;
-/**
- * Types of streams that Apps can subscribe to
- *
- * These are events and data that Apps can receive from the cloud.
- * Not all message types can be subscribed to as streams.
- */
-var StreamType;
-(function (StreamType) {
-    // Hardware streams
-    StreamType["BUTTON_PRESS"] = "button_press";
-    StreamType["HEAD_POSITION"] = "head_position";
-    StreamType["GLASSES_BATTERY_UPDATE"] = "glasses_battery_update";
-    StreamType["PHONE_BATTERY_UPDATE"] = "phone_battery_update";
-    StreamType["GLASSES_CONNECTION_STATE"] = "glasses_connection_state";
-    StreamType["LOCATION_UPDATE"] = "location_update";
-    StreamType["LOCATION_STREAM"] = "location_stream";
-    StreamType["VPS_COORDINATES"] = "vps_coordinates";
-    // Audio streams
-    StreamType["TRANSCRIPTION"] = "transcription";
-    StreamType["TRANSLATION"] = "translation";
-    StreamType["VAD"] = "VAD";
-    StreamType["AUDIO_CHUNK"] = "audio_chunk";
-    // Phone streams
-    StreamType["PHONE_NOTIFICATION"] = "phone_notification";
-    StreamType["PHONE_NOTIFICATION_DISMISSED"] = "phone_notification_dismissed";
-    StreamType["CALENDAR_EVENT"] = "calendar_event";
-    // System streams
-    StreamType["START_APP"] = "start_app";
-    StreamType["STOP_APP"] = "stop_app";
-    StreamType["OPEN_DASHBOARD"] = "open_dashboard";
-    StreamType["CORE_STATUS_UPDATE"] = "core_status_update";
-    // Video streams
-    StreamType["VIDEO"] = "video";
-    StreamType["PHOTO_REQUEST"] = "photo_request";
-    StreamType["PHOTO_RESPONSE"] = "photo_response";
-    StreamType["RTMP_STREAM_STATUS"] = "rtmp_stream_status";
-    StreamType["MANAGED_STREAM_STATUS"] = "managed_stream_status";
-    // Special subscription types
-    StreamType["ALL"] = "all";
-    StreamType["WILDCARD"] = "*";
-    // New stream type
-    StreamType["MENTRAOS_SETTINGS_UPDATE_REQUEST"] = "settings_update_request";
-    StreamType["CUSTOM_MESSAGE"] = "custom_message";
-    StreamType["PHOTO_TAKEN"] = "photo_taken";
-})(StreamType || (exports.StreamType = StreamType = {}));
-/**
- * Categories of stream data
- */
-var StreamCategory;
-(function (StreamCategory) {
-    /** Data from hardware sensors */
-    StreamCategory["HARDWARE"] = "hardware";
-    /** Audio processing results */
-    StreamCategory["AUDIO"] = "audio";
-    /** Phone-related events */
-    StreamCategory["PHONE"] = "phone";
-    /** System-level events */
-    StreamCategory["SYSTEM"] = "system";
-})(StreamCategory || (exports.StreamCategory = StreamCategory = {}));
-/**
- * Map of stream categories for each stream type
- */
-exports.STREAM_CATEGORIES = {
-    [StreamType.BUTTON_PRESS]: StreamCategory.HARDWARE,
-    [StreamType.HEAD_POSITION]: StreamCategory.HARDWARE,
-    [StreamType.GLASSES_BATTERY_UPDATE]: StreamCategory.HARDWARE,
-    [StreamType.PHONE_BATTERY_UPDATE]: StreamCategory.HARDWARE,
-    [StreamType.GLASSES_CONNECTION_STATE]: StreamCategory.HARDWARE,
-    [StreamType.LOCATION_UPDATE]: StreamCategory.HARDWARE,
-    [StreamType.LOCATION_STREAM]: StreamCategory.HARDWARE,
-    [StreamType.VPS_COORDINATES]: StreamCategory.HARDWARE,
-    [StreamType.TRANSCRIPTION]: StreamCategory.AUDIO,
-    [StreamType.TRANSLATION]: StreamCategory.AUDIO,
-    [StreamType.VAD]: StreamCategory.AUDIO,
-    [StreamType.AUDIO_CHUNK]: StreamCategory.AUDIO,
-    [StreamType.PHONE_NOTIFICATION]: StreamCategory.PHONE,
-    [StreamType.PHONE_NOTIFICATION_DISMISSED]: StreamCategory.PHONE,
-    [StreamType.CALENDAR_EVENT]: StreamCategory.PHONE,
-    [StreamType.START_APP]: StreamCategory.SYSTEM,
-    [StreamType.STOP_APP]: StreamCategory.SYSTEM,
-    [StreamType.OPEN_DASHBOARD]: StreamCategory.SYSTEM,
-    [StreamType.CORE_STATUS_UPDATE]: StreamCategory.SYSTEM,
-    [StreamType.VIDEO]: StreamCategory.HARDWARE,
-    [StreamType.PHOTO_REQUEST]: StreamCategory.HARDWARE,
-    [StreamType.PHOTO_RESPONSE]: StreamCategory.HARDWARE,
-    [StreamType.RTMP_STREAM_STATUS]: StreamCategory.HARDWARE,
-    [StreamType.MANAGED_STREAM_STATUS]: StreamCategory.HARDWARE,
-    [StreamType.ALL]: StreamCategory.SYSTEM,
-    [StreamType.WILDCARD]: StreamCategory.SYSTEM,
-    [StreamType.MENTRAOS_SETTINGS_UPDATE_REQUEST]: StreamCategory.SYSTEM,
-    [StreamType.CUSTOM_MESSAGE]: StreamCategory.SYSTEM,
-    [StreamType.PHOTO_TAKEN]: StreamCategory.HARDWARE,
-};
-/**
- * Create a language-branded stream type
- * This is a type helper to ensure type safety for language-specific streams
- */
-function createLanguageStream(type) {
-    return type;
-}
-/**
- * Check if a string is a valid language code
- * Simple validation for language code format: xx-XX (e.g., en-US)
- */
-function isValidLanguageCode(code) {
-    return /^[a-z]{2,3}-[A-Z]{2}$/.test(code);
-}
-/**
- * Parse a subscription string to extract language information
- *
- * @param subscription Subscription string (e.g., "transcription:en-US" or "translation:es-ES-to-en-US" or "transcription:en-US?no-language-identification=true")
- * @returns Parsed language stream info or null if not a language-specific subscription
- */
-function parseLanguageStream(subscription) {
-    console.log(`🎤 Parsing language stream: ${subscription}`);
-    if (typeof subscription !== "string") {
-        return null;
-    }
-    // Handle transcription format (transcription:en-US or transcription:en-US?options)
-    if (subscription.startsWith(`${StreamType.TRANSCRIPTION}:`)) {
-        const [baseType, rest] = subscription.split(":");
-        const [languageCode, queryString] = rest?.split("?") ?? [];
-        if (languageCode && isValidLanguageCode(languageCode)) {
-            const options = {};
-            // Parse query parameters if present
-            if (queryString) {
-                const params = new URLSearchParams(queryString);
-                for (const [key, value] of params.entries()) {
-                    // Convert string values to boolean when appropriate
-                    if (value === "true") {
-                        options[key] = true;
-                    }
-                    else if (value === "false") {
-                        options[key] = false;
-                    }
-                    else {
-                        options[key] = value;
-                    }
-                }
-            }
-            return {
-                type: StreamType.TRANSCRIPTION,
-                baseType,
-                transcribeLanguage: languageCode,
-                options: Object.keys(options).length > 0 ? options : undefined,
-                original: subscription,
-            };
-        }
-    }
-    // Handle translation format (translation:es-ES-to-en-US or translation:es-ES-to-en-US?options)
-    if (subscription.startsWith(`${StreamType.TRANSLATION}:`)) {
-        const [baseType, rest] = subscription.split(":");
-        const [languagePair, queryString] = rest?.split("?") ?? [];
-        const [sourceLanguage, targetLanguage] = languagePair?.split("-to-") ?? [];
-        if (sourceLanguage &&
-            targetLanguage &&
-            isValidLanguageCode(sourceLanguage) &&
-            isValidLanguageCode(targetLanguage)) {
-            const options = {};
-            // Parse query parameters if present
-            if (queryString) {
-                const params = new URLSearchParams(queryString);
-                for (const [key, value] of params.entries()) {
-                    // Convert string values to boolean when appropriate
-                    if (value === "true") {
-                        options[key] = true;
-                    }
-                    else if (value === "false") {
-                        options[key] = false;
-                    }
-                    else {
-                        options[key] = value;
-                    }
-                }
-            }
-            return {
-                type: StreamType.TRANSLATION,
-                baseType,
-                transcribeLanguage: sourceLanguage,
-                translateLanguage: targetLanguage,
-                options: Object.keys(options).length > 0 ? options : undefined,
-                original: subscription,
-            };
-        }
-    }
-    return null;
-}
-/**
- * Create a transcription stream identifier for a specific language
- * Returns a type-safe stream type that can be used like a StreamType
- *
- * @param language Language code (e.g., "en-US")
- * @returns Typed stream identifier
- */
-function createTranscriptionStream(language, options) {
-    console.log(`🎤 Creating transcription stream for language: ${language}`);
-    console.log(`🎤 Options: ${JSON.stringify(options)}`);
-    // Defensively remove any query string from the language parameter
-    const languageCode = language.split("?")[0];
-    if (!isValidLanguageCode(languageCode)) {
-        throw new Error(`Invalid language code: ${languageCode}`);
-    }
-    const base = `${StreamType.TRANSCRIPTION}:${languageCode}`;
-    if (options?.disableLanguageIdentification) {
-        return `${base}?no-language-identification=true`;
-    }
-    return base;
-}
-/**
- * Create a translation stream identifier for a language pair
- * Returns a type-safe stream type that can be used like a StreamType
- *
- * @param sourceLanguage Source language code (e.g., "es-ES")
- * @param targetLanguage Target language code (e.g., "en-US")
- * @param options Optional configuration options
- * @returns Typed stream identifier
- */
-function createTranslationStream(sourceLanguage, targetLanguage, options) {
-    // Defensively remove any query string from the language parameters
-    const cleanSourceLanguage = sourceLanguage.split("?")[0];
-    const cleanTargetLanguage = targetLanguage.split("?")[0];
-    if (!isValidLanguageCode(cleanSourceLanguage) ||
-        !isValidLanguageCode(cleanTargetLanguage)) {
-        throw new Error(`Invalid language code(s): ${cleanSourceLanguage}, ${cleanTargetLanguage}`);
-    }
-    const base = `${StreamType.TRANSLATION}:${cleanSourceLanguage}-to-${cleanTargetLanguage}`;
-    if (options?.disableLanguageIdentification) {
-        return `${base}?no-language-identification=true`;
-    }
-    return createLanguageStream(base);
-}
-/**
- * Check if a subscription is a valid stream type
- * This handles both enum-based StreamType values and language-specific stream formats
- *
- * @param subscription Subscription to validate
- * @returns True if valid, false otherwise
- */
-function isValidStreamType(subscription) {
-    // Check if it's a standard StreamType
-    if (Object.values(StreamType).includes(subscription)) {
-        return true;
-    }
-    // Check if it's a valid language-specific stream
-    const languageStream = parseLanguageStream(subscription);
-    return languageStream !== null;
-}
-/**
- * Helper function to check if a stream type is of a particular category
- * Works with both standard and language-specific stream types
- */
-function isStreamCategory(streamType, category) {
-    const baseType = getBaseStreamType(streamType);
-    return baseType ? exports.STREAM_CATEGORIES[baseType] === category : false;
-}
-/**
- * Helper function to get all stream types in a category
- */
-function getStreamTypesByCategory(category) {
-    return Object.entries(exports.STREAM_CATEGORIES)
-        .filter(([_, cat]) => cat === category)
-        .map(([type]) => type);
-}
-/**
- * Get the base StreamType for a subscription
- * Works with both standard StreamType values and language-specific formats
- *
- * @param subscription Subscription string or StreamType
- * @returns The base StreamType enum value
- */
-function getBaseStreamType(subscription) {
-    // Check if it's already a standard StreamType
-    if (Object.values(StreamType).includes(subscription)) {
-        return subscription;
-    }
-    // Check if it's a language-specific stream
-    const languageStream = parseLanguageStream(subscription);
-    return languageStream?.type ?? null;
-}
-/**
- * Check if a stream is a language-specific stream
- */
-function isLanguageStream(subscription) {
-    return parseLanguageStream(subscription) !== null;
-}
-/**
- * Get language information from a stream type
- * Returns null for regular stream types
- */
-function getLanguageInfo(subscription) {
-    return parseLanguageStream(subscription);
-}

package/dist/types/token.js

@@ -1,7 +0,0 @@
-"use strict";
-/**
- * 🔐 AppToken Types Module
- *
- * Defines types for the App token authentication mechanism.
- */
-Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/webhooks.js

@@ -1,28 +0,0 @@
-"use strict";
-// src/webhook.ts
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.WebhookRequestType = void 0;
-exports.isSessionWebhookRequest = isSessionWebhookRequest;
-exports.isStopWebhookRequest = isStopWebhookRequest;
-/**
- * Types of webhook requests that can be sent to Apps
- */
-var WebhookRequestType;
-(function (WebhookRequestType) {
-    /** Request to start a App session */
-    WebhookRequestType["SESSION_REQUEST"] = "session_request";
-    /** Request to stop a App session */
-    WebhookRequestType["STOP_REQUEST"] = "stop_request";
-})(WebhookRequestType || (exports.WebhookRequestType = WebhookRequestType = {}));
-/**
- * Type guard to check if a webhook request is a session request
- */
-function isSessionWebhookRequest(request) {
-    return request.type === WebhookRequestType.SESSION_REQUEST;
-}
-/**
- * Type guard to check if a webhook request is a stop request
- */
-function isStopWebhookRequest(request) {
-    return request.type === WebhookRequestType.STOP_REQUEST;
-}