@mentra/sdk 1.1.19

package/dist/types/webhooks.js

@@ -0,0 +1,55 @@
+"use strict";
+// src/webhook.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WebhookRequestType = void 0;
+exports.isSessionWebhookRequest = isSessionWebhookRequest;
+exports.isStopWebhookRequest = isStopWebhookRequest;
+exports.isServerRegistrationWebhookRequest = isServerRegistrationWebhookRequest;
+exports.isSessionRecoveryWebhookRequest = isSessionRecoveryWebhookRequest;
+exports.isServerHeartbeatWebhookRequest = isServerHeartbeatWebhookRequest;
+/**
+ * Types of webhook requests that can be sent to TPAs
+ */
+var WebhookRequestType;
+(function (WebhookRequestType) {
+    /** Request to start a TPA session */
+    WebhookRequestType["SESSION_REQUEST"] = "session_request";
+    /** Request to stop a TPA session */
+    WebhookRequestType["STOP_REQUEST"] = "stop_request";
+    /** Server registration confirmation */
+    WebhookRequestType["SERVER_REGISTRATION"] = "server_registration";
+    /** Server heartbeat response */
+    WebhookRequestType["SERVER_HEARTBEAT"] = "server_heartbeat";
+    /** Session recovery request */
+    WebhookRequestType["SESSION_RECOVERY"] = "session_recovery";
+})(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;
+}
+/**
+ * Type guard to check if a webhook request is a server registration request
+ */
+function isServerRegistrationWebhookRequest(request) {
+    return request.type === WebhookRequestType.SERVER_REGISTRATION;
+}
+/**
+ * Type guard to check if a webhook request is a session recovery request
+ */
+function isSessionRecoveryWebhookRequest(request) {
+    return request.type === WebhookRequestType.SESSION_RECOVERY;
+}
+/**
+ * Type guard to check if a webhook request is a server heartbeat request
+ */
+function isServerHeartbeatWebhookRequest(request) {
+    return request.type === WebhookRequestType.SERVER_HEARTBEAT;
+}

package/dist/utils/resource-tracker.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Resource Tracker
+ *
+ * A utility class for tracking and automatically cleaning up resources
+ * like timers, event listeners, and other disposable objects.
+ *
+ * This helps prevent memory leaks by ensuring that all resources are
+ * properly disposed when they're no longer needed.
+ */
+/**
+ * Type for a cleanup function that doesn't take any arguments
+ */
+export type CleanupFunction = () => void;
+/**
+ * Type for any object with a dispose or close method
+ */
+export interface Disposable {
+    dispose?: () => void;
+    close?: () => void;
+}
+/**
+ * Manages resources to prevent memory leaks
+ */
+export declare class ResourceTracker {
+    private cleanupFunctions;
+    private isDisposed;
+    /**
+     * Add a cleanup function to be executed when dispose() is called
+     *
+     * @param cleanup - The cleanup function to register
+     * @returns A function that will remove this cleanup function
+     */
+    track(cleanup: CleanupFunction): CleanupFunction;
+    /**
+     * Track a disposable object (anything with a dispose or close method)
+     *
+     * @param disposable - The object to track
+     * @returns A function that will remove this disposable
+     */
+    trackDisposable(disposable: Disposable): CleanupFunction;
+    /**
+     * Track a timer and ensure it gets cleared
+     *
+     * @param timerId - The timer ID to track
+     * @param isInterval - Whether this is an interval (true) or timeout (false)
+     * @returns A function that will remove this timer
+     */
+    trackTimer(timerId: NodeJS.Timeout, isInterval?: boolean): CleanupFunction;
+    /**
+     * Track a timeout and ensure it gets cleared
+     *
+     * @param timerId - The timeout ID to track
+     * @returns A function that will remove this timeout
+     */
+    trackTimeout(timerId: NodeJS.Timeout): CleanupFunction;
+    /**
+     * Track an interval and ensure it gets cleared
+     *
+     * @param timerId - The interval ID to track
+     * @returns A function that will remove this interval
+     */
+    trackInterval(timerId: NodeJS.Timeout): CleanupFunction;
+    /**
+     * Create a tracked timeout
+     *
+     * @param callback - Function to call when the timeout expires
+     * @param ms - Milliseconds to wait
+     * @returns The timeout ID
+     */
+    setTimeout(callback: (...args: any[]) => void, ms: number): NodeJS.Timeout;
+    /**
+     * Create a tracked interval
+     *
+     * @param callback - Function to call at each interval
+     * @param ms - Milliseconds between intervals
+     * @returns The interval ID
+     */
+    setInterval(callback: (...args: any[]) => void, ms: number): NodeJS.Timeout;
+    /**
+     * Dispose of all tracked resources
+     */
+    dispose(): void;
+    /**
+     * Check if this tracker has been disposed
+     */
+    get disposed(): boolean;
+}
+/**
+ * Create a new ResourceTracker instance
+ *
+ * @returns A new ResourceTracker
+ */
+export declare function createResourceTracker(): ResourceTracker;
+//# sourceMappingURL=resource-tracker.d.ts.map

package/dist/utils/resource-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-tracker.d.ts","sourceRoot":"","sources":["../../src/utils/resource-tracker.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,IAAI,CAAC;AAEzC;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,IAAI,CAAC;CACpB;AAED;;GAEG;AACH,qBAAa,eAAe;IAE1B,OAAO,CAAC,gBAAgB,CAAyB;IAGjD,OAAO,CAAC,UAAU,CAAS;IAE3B;;;;;OAKG;IACH,KAAK,CAAC,OAAO,EAAE,eAAe,GAAG,eAAe;IAgBhD;;;;;OAKG;IACH,eAAe,CAAC,UAAU,EAAE,UAAU,GAAG,eAAe;IAUxD;;;;;;OAMG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,UAAU,UAAQ,GAAG,eAAe;IAUxE;;;;;OAKG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,GAAG,eAAe;IAItD;;;;;OAKG;IACH,aAAa,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,GAAG,eAAe;IAIvD;;;;;;OAMG;IACH,UAAU,CAAC,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC,OAAO;IAM1E;;;;;;OAMG;IACH,WAAW,CAAC,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC,OAAO;IAM3E;;OAEG;IACH,OAAO,IAAI,IAAI;IAmBf;;OAEG;IACH,IAAI,QAAQ,IAAI,OAAO,CAEtB;CACF;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,IAAI,eAAe,CAEvD"}

package/dist/utils/resource-tracker.js

@@ -0,0 +1,153 @@
+"use strict";
+/**
+ * Resource Tracker
+ *
+ * A utility class for tracking and automatically cleaning up resources
+ * like timers, event listeners, and other disposable objects.
+ *
+ * This helps prevent memory leaks by ensuring that all resources are
+ * properly disposed when they're no longer needed.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResourceTracker = void 0;
+exports.createResourceTracker = createResourceTracker;
+/**
+ * Manages resources to prevent memory leaks
+ */
+class ResourceTracker {
+    constructor() {
+        // Collection of cleanup functions to call when dispose() is called
+        this.cleanupFunctions = [];
+        // Flag to track if this resource tracker has been disposed
+        this.isDisposed = false;
+    }
+    /**
+     * Add a cleanup function to be executed when dispose() is called
+     *
+     * @param cleanup - The cleanup function to register
+     * @returns A function that will remove this cleanup function
+     */
+    track(cleanup) {
+        if (this.isDisposed) {
+            throw new Error('Cannot track resources on a disposed ResourceTracker');
+        }
+        this.cleanupFunctions.push(cleanup);
+        // Return a function that will remove this cleanup function
+        return () => {
+            const index = this.cleanupFunctions.indexOf(cleanup);
+            if (index !== -1) {
+                this.cleanupFunctions.splice(index, 1);
+            }
+        };
+    }
+    /**
+     * Track a disposable object (anything with a dispose or close method)
+     *
+     * @param disposable - The object to track
+     * @returns A function that will remove this disposable
+     */
+    trackDisposable(disposable) {
+        return this.track(() => {
+            if (typeof disposable.dispose === 'function') {
+                disposable.dispose();
+            }
+            else if (typeof disposable.close === 'function') {
+                disposable.close();
+            }
+        });
+    }
+    /**
+     * Track a timer and ensure it gets cleared
+     *
+     * @param timerId - The timer ID to track
+     * @param isInterval - Whether this is an interval (true) or timeout (false)
+     * @returns A function that will remove this timer
+     */
+    trackTimer(timerId, isInterval = false) {
+        return this.track(() => {
+            if (isInterval) {
+                clearInterval(timerId);
+            }
+            else {
+                clearTimeout(timerId);
+            }
+        });
+    }
+    /**
+     * Track a timeout and ensure it gets cleared
+     *
+     * @param timerId - The timeout ID to track
+     * @returns A function that will remove this timeout
+     */
+    trackTimeout(timerId) {
+        return this.trackTimer(timerId, false);
+    }
+    /**
+     * Track an interval and ensure it gets cleared
+     *
+     * @param timerId - The interval ID to track
+     * @returns A function that will remove this interval
+     */
+    trackInterval(timerId) {
+        return this.trackTimer(timerId, true);
+    }
+    /**
+     * Create a tracked timeout
+     *
+     * @param callback - Function to call when the timeout expires
+     * @param ms - Milliseconds to wait
+     * @returns The timeout ID
+     */
+    setTimeout(callback, ms) {
+        const timerId = setTimeout(callback, ms);
+        this.trackTimeout(timerId);
+        return timerId;
+    }
+    /**
+     * Create a tracked interval
+     *
+     * @param callback - Function to call at each interval
+     * @param ms - Milliseconds between intervals
+     * @returns The interval ID
+     */
+    setInterval(callback, ms) {
+        const timerId = setInterval(callback, ms);
+        this.trackInterval(timerId);
+        return timerId;
+    }
+    /**
+     * Dispose of all tracked resources
+     */
+    dispose() {
+        if (this.isDisposed) {
+            return;
+        }
+        // Run all cleanup functions
+        for (const cleanup of this.cleanupFunctions) {
+            try {
+                cleanup();
+            }
+            catch (error) {
+                console.error('Error during resource cleanup:', error);
+            }
+        }
+        // Clear the array
+        this.cleanupFunctions = [];
+        this.isDisposed = true;
+    }
+    /**
+     * Check if this tracker has been disposed
+     */
+    get disposed() {
+        return this.isDisposed;
+    }
+}
+exports.ResourceTracker = ResourceTracker;
+/**
+ * Create a new ResourceTracker instance
+ *
+ * @returns A new ResourceTracker
+ */
+function createResourceTracker() {
+    return new ResourceTracker();
+}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@mentra/sdk",
+  "version": "1.1.19",
+  "description": "Build apps for MentraOS smartglasses. This SDK provides everything you need to create real-time smartglasses applications.",
+  "source": "src/index.ts",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    "development": {
+      "import": "./src/index.ts",
+      "require": "./src/index.ts",
+      "types": "./src/index.ts"
+    },
+    "default": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "rm -rf dist && bun x tsc -p tsconfig.json",
+    "dev": "echo 'No build needed in dev mode - using source files directly'",
+    "prepare": "bun run build",
+    "link-pkg": "bun link"
+  },
+  "dependencies": {
+    "@logtail/pino": "^0.5.4",
+    "axios": "^1.8.1",
+    "cookie-parser": "^1.4.7",
+    "dotenv": "^16.4.0",
+    "express": "^4.18.2",
+    "jsonwebtoken": "^8.5.1",
+    "jsrsasign": "^11.1.0",
+    "pino": "^9.6.0",
+    "pino-pretty": "^13.0.0",
+    "ws": "^8.18.2"
+  },
+  "devDependencies": {
+    "@types/babel__core": "^7.20.5",
+    "@types/express": "^4.17.17",
+    "@types/jsonwebtoken": "^9.0.2",
+    "@types/jsrsasign": "^10.5.15",
+    "@types/node": "^20.0.0",
+    "@types/ws": "^8.5.12",
+    "typescript": "^5.0.0"
+  },
+  "files": [
+    "dist"
+  ]
+}