@mentra/sdk 1.1.19

package/dist/tpa/session/settings.js

@@ -0,0 +1,361 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SettingsManager = void 0;
+/**
+ * 🔧 Settings Manager Module
+ *
+ * Manages TPA settings with automatic synchronization and change notifications.
+ * Provides type-safe access to settings with default values.
+ */
+const events_1 = __importDefault(require("events"));
+const api_client_1 = require("./api-client");
+// import { logger } from '@mentra/utils'; // Ensure logger is available
+// Note(Isaiah): Let's not import @mentra/utils in the SDK to avoid circular dependencies. Also i'm deprecating it in favor of the new logging system.
+const logger_1 = require("../../logging/logger"); // Adjust import path as needed
+/**
+ * Internal event names
+ */
+var SettingsEvents;
+(function (SettingsEvents) {
+    SettingsEvents["CHANGE"] = "settings:change";
+    SettingsEvents["VALUE_CHANGE"] = "settings:value:";
+})(SettingsEvents || (SettingsEvents = {}));
+/**
+ * 🔧 Settings Manager
+ *
+ * Provides a type-safe interface for accessing and reacting to TPA settings.
+ * Automatically synchronizes with AugmentOS Cloud.
+ */
+class SettingsManager {
+    /**
+     * Create a new settings manager
+     *
+     * @param initialSettings Initial settings values (if available)
+     * @param packageName Package name for the TPA
+     * @param wsUrl WebSocket URL (for deriving HTTP API URL)
+     * @param userId User ID (for authenticated requests)
+     * @param subscribeFn Optional function to call to subscribe to streams
+     */
+    constructor(initialSettings = [], packageName, wsUrl, userId, subscribeFn // Added parameter
+    ) {
+        // Current settings values
+        this.settings = [];
+        // Event emitter for change notifications
+        this.emitter = new events_1.default();
+        // --- AugmentOS settings event system ---
+        this.augmentosSettings = {};
+        this.augmentosEmitter = new events_1.default();
+        this.settings = [...initialSettings];
+        this.subscribeFn = subscribeFn; // Store the subscribe function
+        // Create API client if we have enough information
+        if (packageName) {
+            this.apiClient = new api_client_1.ApiClient(packageName, wsUrl, userId);
+        }
+    }
+    /**
+     * Configure the API client
+     *
+     * @param packageName Package name for the TPA
+     * @param wsUrl WebSocket URL
+     * @param userId User ID
+     */
+    configureApiClient(packageName, wsUrl, userId) {
+        if (!this.apiClient) {
+            this.apiClient = new api_client_1.ApiClient(packageName, wsUrl, userId);
+        }
+        else {
+            this.apiClient.setWebSocketUrl(wsUrl);
+            this.apiClient.setUserId(userId);
+        }
+    }
+    /**
+     * Update the current settings
+     * This is called internally when settings are loaded or changed
+     *
+     * @param newSettings New settings values
+     * @returns Map of changed settings
+     */
+    updateSettings(newSettings) {
+        const changes = {};
+        // Copy the new settings
+        const updatedSettings = [...newSettings];
+        // Detect changes comparing old and new settings
+        for (const newSetting of updatedSettings) {
+            const oldSetting = this.settings.find(s => s.key === newSetting.key);
+            // Skip if value hasn't changed
+            if (oldSetting && this.areEqual(oldSetting.value, newSetting.value)) {
+                continue;
+            }
+            // Record change
+            changes[newSetting.key] = {
+                oldValue: oldSetting?.value,
+                newValue: newSetting.value
+            };
+        }
+        // Check for removed settings
+        for (const oldSetting of this.settings) {
+            const stillExists = updatedSettings.some(s => s.key === oldSetting.key);
+            if (!stillExists) {
+                changes[oldSetting.key] = {
+                    oldValue: oldSetting.value,
+                    newValue: undefined
+                };
+            }
+        }
+        // If there are changes, update the settings and emit events
+        if (Object.keys(changes).length > 0) {
+            this.settings = updatedSettings;
+            this.emitChanges(changes);
+        }
+        return changes;
+    }
+    /**
+     * Check if two setting values are equal
+     *
+     * @param a First value
+     * @param b Second value
+     * @returns True if the values are equal
+     */
+    areEqual(a, b) {
+        // Simple equality check - for objects, this won't do a deep equality check
+        // but for most setting values (strings, numbers, booleans) it works
+        return a === b;
+    }
+    /**
+     * Emit change events for updated settings
+     *
+     * @param changes Map of changed settings
+     */
+    emitChanges(changes) {
+        // Emit the general change event
+        this.emitter.emit(SettingsEvents.CHANGE, changes);
+        // Emit individual value change events
+        for (const [key, change] of Object.entries(changes)) {
+            this.emitter.emit(`${SettingsEvents.VALUE_CHANGE}${key}`, change.newValue, change.oldValue);
+        }
+    }
+    /**
+     * 🔄 Listen for changes to any setting
+     *
+     * @param handler Function to call when settings change
+     * @returns Function to remove the listener
+     *
+     * @example
+     * ```typescript
+     * settings.onChange((changes) => {
+     *   console.log('Settings changed:', changes);
+     * });
+     * ```
+     */
+    onChange(handler) {
+        this.emitter.on(SettingsEvents.CHANGE, handler);
+        return () => this.emitter.off(SettingsEvents.CHANGE, handler);
+    }
+    /**
+     * 🔄 Listen for changes to a specific setting
+     *
+     * @param key Setting key to monitor
+     * @param handler Function to call when the setting changes
+     * @returns Function to remove the listener
+     *
+     * @example
+     * ```typescript
+     * settings.onValueChange('transcribe_language', (newValue, oldValue) => {
+     *   console.log(`Language changed from ${oldValue} to ${newValue}`);
+     * });
+     * ```
+     */
+    onValueChange(key, handler) {
+        const eventName = `${SettingsEvents.VALUE_CHANGE}${key}`;
+        this.emitter.on(eventName, handler);
+        return () => this.emitter.off(eventName, handler);
+    }
+    /**
+     * 🔍 Check if a setting exists
+     *
+     * @param key Setting key to check
+     * @returns True if the setting exists
+     */
+    has(key) {
+        return this.settings.some(s => s.key === key);
+    }
+    /**
+     * 🔍 Get all settings
+     *
+     * @returns Copy of all settings
+     */
+    getAll() {
+        return [...this.settings];
+    }
+    /**
+     * 🔍 Get a setting value with type safety
+     *
+     * @param key Setting key to get
+     * @param defaultValue Default value if setting doesn't exist or is undefined
+     * @returns Setting value or default value
+     *
+     * @example
+     * ```typescript
+     * const lineWidth = settings.get<number>('line_width', 30);
+     * const language = settings.get<string>('transcribe_language', 'English');
+     * ```
+     */
+    get(key, defaultValue) {
+        const setting = this.settings.find(s => s.key === key);
+        if (setting && setting.value !== undefined) {
+            return setting.value;
+        }
+        return defaultValue;
+    }
+    /**
+     * 🎛️ Get an AugmentOS system setting value with optional default
+     *
+     * @param key AugmentOS setting key (e.g., 'metricSystemEnabled', 'brightness')
+     * @param defaultValue Default value to return if the setting is not found
+     * @returns The setting value or the default value
+     *
+     * @example
+     * ```typescript
+     * const isMetric = settings.getAugmentOS<boolean>('metricSystemEnabled', false);
+     * const brightness = settings.getAugmentOS<number>('brightness', 50);
+     * ```
+     */
+    getAugmentOS(key, defaultValue) {
+        const value = this.augmentosSettings[key];
+        if (value !== undefined) {
+            return value;
+        }
+        return defaultValue;
+    }
+    /**
+     * 🔍 Find a setting by key
+     *
+     * @param key Setting key to find
+     * @returns Setting object or undefined
+     */
+    getSetting(key) {
+        return this.settings.find(s => s.key === key);
+    }
+    /**
+     * 🔄 Fetch settings from the cloud
+     * This is generally not needed since settings are automatically kept in sync,
+     * but can be used to force a refresh if needed.
+     *
+     * @returns Promise that resolves to the updated settings
+     * @throws Error if the API client is not configured or the request fails
+     */
+    async fetch() {
+        if (!this.apiClient) {
+            throw new Error('Settings API client is not configured');
+        }
+        try {
+            const newSettings = await this.apiClient.fetchSettings();
+            this.updateSettings(newSettings);
+            return this.settings;
+        }
+        catch (error) {
+            console.error('Error fetching settings:', error);
+            throw error;
+        }
+    }
+    /**
+     * 🎛️ Listen for changes to a specific AugmentOS setting (e.g., metricSystemEnabled)
+     *
+     * @param key The augmentosSettings key to listen for (e.g., 'metricSystemEnabled')
+     * @param handler Function to call when the value changes
+     * @returns Function to remove the listener
+     *
+     * @example
+     * ```typescript
+     * settings.onAugmentOSChange('metricSystemEnabled', (isMetric, wasMetric) => {
+     *   console.log(`Units changed: ${wasMetric ? 'metric' : 'imperial'} → ${isMetric ? 'metric' : 'imperial'}`);
+     * });
+     * ```
+     */
+    onAugmentOSChange(key, handler) {
+        return this.onAugmentosSettingChange(key, handler);
+    }
+    /**
+     * Listen for changes to a specific AugmentOS setting (e.g., metricSystemEnabled)
+     * This is a convenience wrapper for onValueChange for well-known augmentosSettings keys.
+     * @param key The augmentosSettings key to listen for (e.g., 'metricSystemEnabled')
+     * @param handler Function to call when the value changes
+     * @returns Function to remove the listener
+     * @deprecated Use onAugmentOSChange instead
+     */
+    onAugmentosSettingsChange(key, handler) {
+        return this.onAugmentosSettingChange(key, handler);
+    }
+    /**
+     * Update the current AugmentOS settings
+     * Compares new and old values, emits per-key events, and updates stored values.
+     * @param newSettings The new AugmentOS settings object
+     */
+    updateAugmentosSettings(newSettings) {
+        const oldSettings = this.augmentosSettings;
+        logger_1.logger.debug(`[SettingsManager] Updating AugmentOS settings. New settings:`, newSettings);
+        for (const key of Object.keys(newSettings)) {
+            const oldValue = oldSettings[key];
+            const newValue = newSettings[key];
+            if (oldValue !== newValue) {
+                logger_1.logger.info(`[SettingsManager] AugmentOS setting '${key}' changed: ${oldValue} -> ${newValue}. Emitting event.`);
+                this.augmentosEmitter.emit(`augmentos:value:${key}`, newValue, oldValue);
+            }
+        }
+        // Also handle keys that might have been removed from newSettings but existed in oldSettings
+        for (const key of Object.keys(oldSettings)) {
+            if (!(key in newSettings)) {
+                logger_1.logger.info(`[SettingsManager] AugmentOS setting '${key}' removed. Old value: ${oldSettings[key]}. Emitting event with undefined newValue.`);
+                this.augmentosEmitter.emit(`augmentos:value:${key}`, undefined, oldSettings[key]);
+            }
+        }
+        this.augmentosSettings = { ...newSettings };
+        logger_1.logger.debug(`[SettingsManager] Finished updating AugmentOS settings. Current state:`, this.augmentosSettings);
+    }
+    /**
+     * Subscribe to changes for a specific AugmentOS setting (e.g., 'metricSystemEnabled')
+     * @param key The AugmentOS setting key to listen for
+     * @param handler Function to call when the value changes (newValue, oldValue)
+     * @returns Function to remove the listener
+     */
+    onAugmentosSettingChange(key, handler) {
+        const eventName = `augmentos:value:${key}`;
+        logger_1.logger.info(`[SettingsManager] Registering handler for AugmentOS setting '${key}' on event '${eventName}'.`);
+        this.augmentosEmitter.on(eventName, (...args) => {
+            logger_1.logger.info(`[SettingsManager] AugmentOS setting '${key}' event fired. Args:`, args);
+            handler(...args);
+        });
+        if (this.subscribeFn) {
+            const subscriptionKey = `augmentos:${key}`;
+            logger_1.logger.info(`[SettingsManager] Calling subscribeFn for stream '${subscriptionKey}'.`);
+            this.subscribeFn([subscriptionKey])
+                .then(() => {
+                logger_1.logger.info(`[SettingsManager] subscribeFn resolved for stream '${subscriptionKey}'.`);
+            })
+                .catch(err => {
+                logger_1.logger.error(`[SettingsManager] subscribeFn failed for stream '${subscriptionKey}':`, err);
+            });
+        }
+        else {
+            logger_1.logger.warn(`[SettingsManager] 'subscribeFn' not provided. Cannot auto-subscribe for AugmentOS setting '${key}'. Manual TPA subscription might be required.`);
+        }
+        return () => {
+            logger_1.logger.info(`[SettingsManager] Unregistering handler for AugmentOS setting '${key}' from event '${eventName}'.`);
+            this.augmentosEmitter.off(eventName, handler);
+        };
+    }
+    /**
+     * Get the current value of an AugmentOS setting
+     */
+    getAugmentosSetting(key, defaultValue) {
+        console.log(`[SettingsManager] Getting AugmentOS setting '${key}' with settings:`, this.augmentosSettings);
+        if (key in this.augmentosSettings) {
+            return this.augmentosSettings[key];
+        }
+        return defaultValue;
+    }
+}
+exports.SettingsManager = SettingsManager;

package/dist/tpa/token/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 🔐 TPA Token Module
+ *
+ * Provides utilities for working with TPA tokens.
+ */
+export * from './utils';
+//# sourceMappingURL=index.d.ts.map

package/dist/tpa/token/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tpa/token/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,cAAc,SAAS,CAAC"}

package/dist/tpa/token/index.js

@@ -0,0 +1,22 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * 🔐 TPA Token Module
+ *
+ * Provides utilities for working with TPA tokens.
+ */
+__exportStar(require("./utils"), exports);

package/dist/tpa/token/utils.d.ts

@@ -0,0 +1,69 @@
+import { TpaTokenPayload, TokenValidationResult, TokenConfig } from '../../types/token';
+/**
+ * Create a TPA token for a user session
+ *
+ * @param payload - Token payload data
+ * @param config - Token configuration
+ * @returns JWT token string
+ *
+ * @example
+ * ```typescript
+ * const token = createToken(
+ *   {
+ *     userId: 'user123',
+ *     packageName: 'org.example.myapp',
+ *     sessionId: 'session789'
+ *   },
+ *   { secretKey: 'your_secret_key' }
+ * );
+ * ```
+ */
+export declare function createToken(payload: Omit<TpaTokenPayload, 'iat' | 'exp'>, config: TokenConfig): string;
+/**
+ * Validate and decode a TPA token
+ *
+ * @param token - JWT token string
+ * @param secretKey - Secret key used for validation
+ * @returns Token validation result
+ *
+ * @example
+ * ```typescript
+ * const result = validateToken('eyJhbGciOiJIUzI1...', 'your_secret_key');
+ * if (result.valid) {
+ *   // Use result.payload
+ * }
+ * ```
+ */
+export declare function validateToken(token: string, secretKey: string): TokenValidationResult;
+/**
+ * Generate a webview URL with an embedded TPA token
+ *
+ * @param baseUrl - Base URL of the webview
+ * @param token - JWT token string
+ * @returns Full URL with token parameter
+ *
+ * @example
+ * ```typescript
+ * const url = generateWebviewUrl(
+ *   'https://example.com/webview',
+ *   'eyJhbGciOiJIUzI1...'
+ * );
+ * // Returns: https://example.com/webview?token=eyJhbGciOiJIUzI1...
+ * ```
+ */
+export declare function generateWebviewUrl(baseUrl: string, token: string): string;
+/**
+ * Extract a TPA token from a URL
+ *
+ * @param url - URL string containing a token parameter
+ * @returns Token string or null if not found
+ *
+ * @example
+ * ```typescript
+ * const token = extractTokenFromUrl(
+ *   'https://example.com/webview?token=eyJhbGciOiJIUzI1...'
+ * );
+ * ```
+ */
+export declare function extractTokenFromUrl(url: string): string | null;
+//# sourceMappingURL=utils.d.ts.map

package/dist/tpa/token/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/tpa/token/utils.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAOxF;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,IAAI,CAAC,eAAe,EAAE,KAAK,GAAG,KAAK,CAAC,EAC7C,MAAM,EAAE,WAAW,GAClB,MAAM,CAMR;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,GAChB,qBAAqB,CAavB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAIzE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAO9D"}

package/dist/tpa/token/utils.js

@@ -0,0 +1,144 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createToken = createToken;
+exports.validateToken = validateToken;
+exports.generateWebviewUrl = generateWebviewUrl;
+exports.extractTokenFromUrl = extractTokenFromUrl;
+/**
+ * 🔐 TPA Token Utilities
+ *
+ * Provides utilities for working with TPA tokens.
+ */
+const jwt = __importStar(require("jsonwebtoken"));
+/**
+ * Default token expiration (1 day)
+ */
+const DEFAULT_EXPIRATION = 60 * 60 * 24; // seconds * minutes * hours (1 day).
+/**
+ * Create a TPA token for a user session
+ *
+ * @param payload - Token payload data
+ * @param config - Token configuration
+ * @returns JWT token string
+ *
+ * @example
+ * ```typescript
+ * const token = createToken(
+ *   {
+ *     userId: 'user123',
+ *     packageName: 'org.example.myapp',
+ *     sessionId: 'session789'
+ *   },
+ *   { secretKey: 'your_secret_key' }
+ * );
+ * ```
+ */
+function createToken(payload, config) {
+    return jwt.sign(payload, config.secretKey, { expiresIn: config.expiresIn || DEFAULT_EXPIRATION });
+}
+/**
+ * Validate and decode a TPA token
+ *
+ * @param token - JWT token string
+ * @param secretKey - Secret key used for validation
+ * @returns Token validation result
+ *
+ * @example
+ * ```typescript
+ * const result = validateToken('eyJhbGciOiJIUzI1...', 'your_secret_key');
+ * if (result.valid) {
+ *   // Use result.payload
+ * }
+ * ```
+ */
+function validateToken(token, secretKey) {
+    try {
+        const decoded = jwt.verify(token, secretKey);
+        return {
+            valid: true,
+            payload: decoded
+        };
+    }
+    catch (error) {
+        return {
+            valid: false,
+            error: error instanceof Error ? error.message : 'Unknown error'
+        };
+    }
+}
+/**
+ * Generate a webview URL with an embedded TPA token
+ *
+ * @param baseUrl - Base URL of the webview
+ * @param token - JWT token string
+ * @returns Full URL with token parameter
+ *
+ * @example
+ * ```typescript
+ * const url = generateWebviewUrl(
+ *   'https://example.com/webview',
+ *   'eyJhbGciOiJIUzI1...'
+ * );
+ * // Returns: https://example.com/webview?token=eyJhbGciOiJIUzI1...
+ * ```
+ */
+function generateWebviewUrl(baseUrl, token) {
+    const url = new URL(baseUrl);
+    url.searchParams.append('token', token);
+    return url.toString();
+}
+/**
+ * Extract a TPA token from a URL
+ *
+ * @param url - URL string containing a token parameter
+ * @returns Token string or null if not found
+ *
+ * @example
+ * ```typescript
+ * const token = extractTokenFromUrl(
+ *   'https://example.com/webview?token=eyJhbGciOiJIUzI1...'
+ * );
+ * ```
+ */
+function extractTokenFromUrl(url) {
+    try {
+        const parsedUrl = new URL(url);
+        return parsedUrl.searchParams.get('token');
+    }
+    catch (error) {
+        return null;
+    }
+}

package/dist/tpa/webview/index.d.ts

@@ -0,0 +1,47 @@
+import { Response, NextFunction } from 'express';
+import { AuthenticatedRequest } from '../../types';
+/**
+ * Extracts the temporary token from a URL string.
+ * @param url The URL string, typically window.location.href.
+ * @returns The token string or null if not found.
+ */
+export declare function extractTempToken(url: string): string | null;
+/**
+ * Exchanges a temporary token for a user ID with the AugmentOS Cloud.
+ * This should be called from the TPA's backend server.
+ * @param cloudApiUrl The base URL of the AugmentOS Cloud API.
+ * @param tempToken The temporary token obtained from the webview URL.
+ * @param apiKey Your TPA's secret API key.
+ * @returns A Promise that resolves with an object containing the userId.
+ * @throws Throws an error if the exchange fails (e.g., invalid token, expired, network error).
+ */
+export declare function exchangeToken(cloudApiUrl: string, tempToken: string, apiKey: string, packageName: string): Promise<{
+    userId: string;
+}>;
+/**
+ * Express middleware for automatically handling the token exchange.
+ * Assumes API key and Cloud URL are available (e.g., via environment variables).
+ * Adds `req.authUserId` if successful.
+ *
+ * @param options Configuration options.
+ * @param options.cloudApiUrl The base URL of the AugmentOS Cloud API.
+ * @param options.apiKey Your TPA's secret API key.
+ * @param options.tokenQueryParam The name of the query parameter containing the token (default: 'aos_temp_token').
+ * @param options.cookieName The name of the cookie to store the session token (default: 'aos_session').
+ * @param options.cookieSecret Secret key used to sign the session cookie. MUST be provided and kept secure.
+ * @param options.cookieOptions Options for the session cookie (default: { httpOnly: true, secure: process.env.NODE_ENV === 'production' }).
+ */
+export declare function createAuthMiddleware(options: {
+    apiKey: string;
+    packageName: string;
+    cookieName?: string;
+    cookieSecret: string;
+    cookieOptions?: {
+        httpOnly?: boolean;
+        secure?: boolean;
+        maxAge?: number;
+        sameSite?: boolean | 'lax' | 'strict' | 'none';
+        path?: string;
+    };
+}): (req: AuthenticatedRequest, res: Response, next: NextFunction) => Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/tpa/webview/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tpa/webview/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAUnD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQ3D;AAED;;;;;;;;GAQG;AACH,wBAAsB,aAAa,CACjC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAmC7B;AAsID;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE;IAC5C,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE;QACd,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,OAAO,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;QAC/C,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;CACH,IAuBe,KAAK,oBAAoB,EAAE,KAAK,QAAQ,EAAE,MAAM,YAAY,mBAkG3E"}