@blaxel/core 0.2.52 → 0.2.53-preview.11

package/dist/cjs-browser/common/autoload.js

@@ -6,6 +6,7 @@ const client_gen_js_1 = require("../client/client.gen.js");
 const interceptors_js_1 = require("../client/interceptors.js");
 const responseInterceptor_js_1 = require("../client/responseInterceptor.js");
 const client_gen_js_2 = require("../sandbox/client/client.gen.js");
+const sentry_js_1 = require("./sentry.js");
 const settings_js_1 = require("./settings.js");
 client_gen_js_1.client.setConfig({
     baseUrl: settings_js_1.settings.baseUrl,
@@ -22,6 +23,8 @@ for (const interceptor of responseInterceptor_js_1.responseInterceptors) {
     client_gen_js_1.client.interceptors.response.use(interceptor);
     client_gen_js_2.client.interceptors.response.use(interceptor);
 }
+// Initialize Sentry for SDK error tracking immediately when module loads
+(0, sentry_js_1.initSentry)();
 // Allow to set custom configuration for browser environment
 function initialize(config) {
     settings_js_1.settings.setConfig(config);

package/dist/cjs-browser/common/sentry.js

@@ -0,0 +1,226 @@
+"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.initSentry = initSentry;
+exports.flushSentry = flushSentry;
+exports.isSentryInitialized = isSentryInitialized;
+const settings_js_1 = require("./settings.js");
+const Sentry = __importStar(require("@sentry/node"));
+const node_1 = require("@sentry/node");
+// Isolated Sentry client for SDK-only error tracking (doesn't interfere with user's Sentry)
+let sentryClient = null;
+const capturedExceptions = new Set();
+let handlersRegistered = false;
+// SDK path patterns to identify errors originating from our SDK
+const SDK_PATTERNS = [
+    "@blaxel/",
+    "blaxel-sdk",
+    "/node_modules/@blaxel/",
+    "/@blaxel/core/",
+    "/@blaxel/telemetry/",
+];
+/**
+ * Check if an error originated from the SDK based on its stack trace.
+ * Returns true if the stack trace contains any SDK-related paths.
+ */
+function isFromSDK(error) {
+    const stack = error.stack || "";
+    return SDK_PATTERNS.some((pattern) => stack.includes(pattern));
+}
+/**
+ * Initialize an isolated Sentry client for SDK error tracking.
+ * This creates a separate Sentry instance that won't interfere with any
+ * Sentry configuration the user might have in their application.
+ */
+function initSentry() {
+    try {
+        // Check if tracking is disabled
+        if (!settings_js_1.settings.tracking) {
+            return;
+        }
+        const dsn = settings_js_1.settings.sentryDsn;
+        if (!dsn) {
+            return;
+        }
+        // Create an isolated Sentry client that doesn't touch the global scope
+        // This allows users to have their own Sentry.init() without conflicts
+        sentryClient = new Sentry.NodeClient({
+            dsn,
+            environment: settings_js_1.settings.env,
+            release: `sdk-typescript@${settings_js_1.settings.version}`,
+            transport: node_1.makeNodeTransport,
+            stackParser: Sentry.defaultStackParser,
+            // No integrations - we handle error capturing manually
+            integrations: [],
+            // Disable traces for the SDK client
+            tracesSampleRate: 0,
+            // Filter errors before sending - only send SDK errors
+            beforeSend(event, hint) {
+                if (event.environment !== 'dev' && event.environment !== 'prod') {
+                    return null;
+                }
+                const error = hint.originalException;
+                if (error instanceof Error) {
+                    if (!isFromSDK(error)) {
+                        // Drop errors that don't originate from SDK
+                        return null;
+                    }
+                }
+                return event;
+            },
+        });
+        sentryClient.init();
+        // Set SDK-specific tags
+        const scope = new Sentry.Scope();
+        scope.setTag("blaxel.workspace", settings_js_1.settings.workspace);
+        scope.setTag("blaxel.version", settings_js_1.settings.version);
+        scope.setTag("blaxel.commit", settings_js_1.settings.commit);
+        scope.setClient(sentryClient);
+        // Register process handlers for uncaught errors (Node.js only)
+        // Only register once to prevent memory leaks
+        if (typeof process !== "undefined" &&
+            typeof process.on === "function" &&
+            !handlersRegistered) {
+            handlersRegistered = true;
+            // For SIGTERM/SIGINT, flush before exit
+            const signalHandler = (signal) => {
+                flushSentry(500)
+                    .catch(() => {
+                    // Silently fail
+                })
+                    .finally(() => {
+                    process.exit(signal === "SIGTERM" ? 143 : 130);
+                });
+            };
+            // Uncaught exception handler - only capture SDK errors
+            const uncaughtExceptionHandler = (error) => {
+                if (isFromSDK(error)) {
+                    captureException(error);
+                }
+                // Let the default Node.js behavior handle the process exit
+            };
+            // Unhandled rejection handler - only capture SDK errors
+            const unhandledRejectionHandler = (reason) => {
+                const error = reason instanceof Error ? reason : new Error(String(reason));
+                if (isFromSDK(error)) {
+                    captureException(error);
+                }
+            };
+            process.on("SIGTERM", () => signalHandler("SIGTERM"));
+            process.on("SIGINT", () => signalHandler("SIGINT"));
+            process.on("uncaughtException", uncaughtExceptionHandler);
+            process.on("unhandledRejection", unhandledRejectionHandler);
+            // Intercept console.error to capture SDK errors that are caught and logged
+            const originalConsoleError = console.error;
+            console.error = function (...args) {
+                // Call the original console.error first
+                originalConsoleError.apply(console, args);
+                // Check if any argument is an Error from SDK and capture it
+                for (const arg of args) {
+                    if (arg instanceof Error && isFromSDK(arg)) {
+                        captureException(arg);
+                        break; // Only capture the first SDK error to avoid duplicates
+                    }
+                }
+            };
+        }
+    }
+    catch (error) {
+        // Silently fail - Sentry initialization should never break the SDK
+        if (settings_js_1.settings.env !== "production") {
+            console.error("[Blaxel SDK] Error initializing Sentry:", error);
+        }
+    }
+}
+/**
+ * Capture an exception to the SDK's isolated Sentry client.
+ * Only errors originating from SDK code will be captured.
+ *
+ * @param error - The error to capture
+ */
+function captureException(error) {
+    if (sentryClient === null) {
+        return;
+    }
+    // Double-check that error is from SDK (defense in depth)
+    if (!isFromSDK(error)) {
+        return;
+    }
+    try {
+        // Create a unique identifier for this exception to avoid duplicates
+        const errorKey = `${error.name}:${error.message}:${error.stack?.slice(0, 200)}`;
+        if (capturedExceptions.has(errorKey)) {
+            return;
+        }
+        capturedExceptions.add(errorKey);
+        // Clean up old exception keys to prevent memory leak
+        if (capturedExceptions.size > 1000) {
+            capturedExceptions.clear();
+        }
+        // Create a scope with SDK tags and capture the exception
+        const scope = new Sentry.Scope();
+        scope.setTag("blaxel.workspace", settings_js_1.settings.workspace);
+        scope.setTag("blaxel.version", settings_js_1.settings.version);
+        scope.setTag("blaxel.commit", settings_js_1.settings.commit);
+        scope.setClient(sentryClient);
+        scope.captureException(error);
+    }
+    catch {
+        // Silently fail - error capturing should never break the SDK
+    }
+}
+/**
+ * Flush pending Sentry events.
+ * This should be called before the process exits to ensure all events are sent.
+ *
+ * @param timeout - Maximum time in milliseconds to wait for flush (default: 2000)
+ */
+async function flushSentry(timeout = 2000) {
+    if (sentryClient === null) {
+        return;
+    }
+    try {
+        await sentryClient.flush(timeout);
+    }
+    catch {
+        // Silently fail
+    }
+}
+/**
+ * Check if Sentry is initialized and available.
+ */
+function isSentryInitialized() {
+    return sentryClient !== null;
+}

package/dist/cjs-browser/common/settings.js

@@ -1,27 +1,41 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.settings = void 0;
+const yaml_1 = __importDefault(require("yaml"));
 const index_js_1 = require("../authentication/index.js");
 const env_js_1 = require("../common/env.js");
-// Function to get package version
-function getPackageVersion() {
+const node_js_1 = require("../common/node.js");
+// Build info - these placeholders are replaced at build time by build:replace-imports
+const BUILD_VERSION = "0.2.53-preview.11";
+const BUILD_COMMIT = "1a161063708104c65ae116d189af51e3b9cc5ef7";
+const BUILD_SENTRY_DSN = "https://fd5e60e1c9820e1eef5ccebb84a07127@o4508714045276160.ingest.us.sentry.io/4510465864564736";
+// Cache for config.yaml tracking value
+let configTrackingValue = null;
+let configTrackingLoaded = false;
+function getConfigTracking() {
+    if (configTrackingLoaded) {
+        return configTrackingValue;
+    }
+    configTrackingLoaded = true;
+    if (node_js_1.os === null || node_js_1.fs === null || node_js_1.path === null) {
+        return null;
+    }
     try {
-        // Check if require is available (CommonJS environment)
-        if (typeof require !== "undefined") {
-            // Try to require package.json (Node.js only, gracefully fails in browser)
-            // eslint-disable-next-line @typescript-eslint/no-require-imports
-            const packageJson = {"version":"0.2.52","commit":"4acd7b5efa6c9e04c5131f55e7a87029c4889b1d"};
-            return packageJson.version || "unknown";
-        }
-        else {
-            // ESM environment - return unknown
-            return "unknown";
+        const homeDir = node_js_1.os.homedir();
+        const config = node_js_1.fs.readFileSync(node_js_1.path.join(homeDir, ".blaxel/config.yaml"), "utf8");
+        const configJson = yaml_1.default.parse(config);
+        if (typeof configJson.tracking === 'boolean') {
+            configTrackingValue = configJson.tracking;
+            return configTrackingValue;
         }
     }
     catch {
-        // Fallback for browser environments or if require fails
-        return "unknown";
+        // If any error, return null
     }
+    return null;
 }
 // Function to get OS and architecture
 function getOsArch() {
@@ -55,30 +69,9 @@ function getOsArch() {
     }
     return "browser/unknown";
 }
-// Function to get commit hash
-function getCommitHash() {
-    try {
-        // Check if require is available (CommonJS environment)
-        if (typeof require !== "undefined") {
-            // Try to require package.json and look for commit field (set during build)
-            // eslint-disable-next-line @typescript-eslint/no-require-imports
-            const packageJson = {"version":"0.2.52","commit":"4acd7b5efa6c9e04c5131f55e7a87029c4889b1d"};
-            // Check for commit in various possible locations
-            const commit = packageJson.commit || packageJson.buildInfo?.commit;
-            if (commit) {
-                return commit.length > 7 ? commit.substring(0, 7) : commit;
-            }
-        }
-    }
-    catch {
-        // Fallback for browser environments or if require fails
-    }
-    return "unknown";
-}
 class Settings {
     credentials;
     config;
-    _version = null;
     constructor() {
         this.credentials = (0, index_js_1.authentication)();
         this.config = {
@@ -133,18 +126,21 @@ class Settings {
         return this.credentials.token;
     }
     get version() {
-        if (this._version === null) {
-            this._version = getPackageVersion();
-        }
-        return this._version;
+        return BUILD_VERSION || "unknown";
+    }
+    get commit() {
+        const commit = BUILD_COMMIT || "unknown";
+        return commit.length > 7 ? commit.substring(0, 7) : commit;
+    }
+    get sentryDsn() {
+        return BUILD_SENTRY_DSN || "";
     }
     get headers() {
         const osArch = getOsArch();
-        const commitHash = getCommitHash();
         return {
             "x-blaxel-authorization": this.authorization,
             "x-blaxel-workspace": this.workspace || "",
-            "User-Agent": `blaxel/sdk/typescript/${this.version} (${osArch}) blaxel/${commitHash}`,
+            "User-Agent": `blaxel/sdk/typescript/${this.version} (${osArch}) blaxel/${this.commit}`,
         };
     }
     get name() {
@@ -171,6 +167,19 @@ class Settings {
     get loggerType() {
         return env_js_1.env.BL_LOGGER || "http";
     }
+    get tracking() {
+        // Environment variable has highest priority
+        if (env_js_1.env.BL_TRACKING !== undefined) {
+            return env_js_1.env.BL_TRACKING === "true";
+        }
+        // Then check config.yaml
+        const configValue = getConfigTracking();
+        if (configValue !== null) {
+            return configValue;
+        }
+        // Default to true if neither is set
+        return true;
+    }
     async authenticate() {
         await this.credentials.authenticate();
     }

package/dist/cjs-browser/types/common/sentry.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Initialize an isolated Sentry client for SDK error tracking.
+ * This creates a separate Sentry instance that won't interfere with any
+ * Sentry configuration the user might have in their application.
+ */
+export declare function initSentry(): void;
+/**
+ * Flush pending Sentry events.
+ * This should be called before the process exits to ensure all events are sent.
+ *
+ * @param timeout - Maximum time in milliseconds to wait for flush (default: 2000)
+ */
+export declare function flushSentry(timeout?: number): Promise<void>;
+/**
+ * Check if Sentry is initialized and available.
+ */
+export declare function isSentryInitialized(): boolean;

package/dist/cjs-browser/types/common/settings.d.ts

@@ -7,7 +7,6 @@ export type Config = {
 declare class Settings {
     credentials: Credentials;
     config: Config;
-    private _version;
     constructor();
     setConfig(config: Config): void;
     get env(): string;
@@ -17,6 +16,8 @@ declare class Settings {
     get authorization(): string;
     get token(): string;
     get version(): string;
+    get commit(): string;
+    get sentryDsn(): string;
     get headers(): Record<string, string>;
     get name(): string;
     get type(): string;
@@ -25,6 +26,7 @@ declare class Settings {
     get blCloud(): boolean;
     get generation(): string;
     get loggerType(): string;
+    get tracking(): boolean;
     authenticate(): Promise<void>;
 }
 export declare const settings: Settings;