@blaxel/core 0.2.18 → 0.2.19-dev.158

package/dist/sandbox/index.d.ts

@@ -1,3 +1,4 @@
-export { deleteFilesystemByPath, deleteNetworkProcessByPidMonitor, deleteProcessByIdentifier, deleteProcessByIdentifierKill, Directory, ErrorResponse, File, FileRequest, FileWithContent, getFilesystemByPath, getNetworkProcessByPidPorts, getProcess, getProcessByIdentifier, getProcessByIdentifierLogs, getProcessByIdentifierLogsStream, PortMonitorRequest, postNetworkProcessByPidMonitor, postProcess, ProcessRequest, ProcessResponse, putFilesystemByPath, SuccessResponse } from "./client/index.js";
+export { Directory, ErrorResponse, File, FileRequest, FileWithContent, PortMonitorRequest, ProcessRequest, ProcessResponse, SuccessResponse, deleteFilesystemByPath, deleteNetworkProcessByPidMonitor, deleteProcessByIdentifier, deleteProcessByIdentifierKill, getFilesystemByPath, getNetworkProcessByPidPorts, getProcess, getProcessByIdentifier, getProcessByIdentifierLogs, getProcessByIdentifierLogsStream, postNetworkProcessByPidMonitor, postProcess, putFilesystemByPath } from "./client/index.js";
 export * from "./filesystem/index.js";
 export * from "./sandbox.js";
+export * from "./types.js";

package/dist/sandbox/index.js

@@ -32,4 +32,5 @@ Object.defineProperty(exports, "postProcess", { enumerable: true, get: function
 Object.defineProperty(exports, "putFilesystemByPath", { enumerable: true, get: function () { return index_js_1.putFilesystemByPath; } });
 __exportStar(require("./filesystem/index.js"), exports);
 __exportStar(require("./sandbox.js"), exports);
+__exportStar(require("./types.js"), exports);
 // Re-export everything from client except ClientOptions to avoid conflict

package/dist/sandbox/sandbox.js

@@ -9,6 +9,7 @@ const index_js_3 = require("./network/index.js");
 const preview_js_1 = require("./preview.js");
 const index_js_4 = require("./process/index.js");
 const session_js_1 = require("./session.js");
+const types_js_1 = require("./types.js");
 class SandboxInstance {
     sandbox;
     fs;
@@ -65,7 +66,8 @@ class SandboxInstance {
         const defaultName = `sandbox-${(0, uuid_1.v4)().replace(/-/g, '').substring(0, 8)}`;
         const defaultImage = "blaxel/prod-base:latest";
         const defaultMemory = 4096;
-        if (!sandbox || 'name' in sandbox || 'image' in sandbox || 'memory' in sandbox) {
+        // Handle SandboxCreateConfiguration or simple dict with name/image/memory/ports keys
+        if (!sandbox || 'name' in sandbox || 'image' in sandbox || 'memory' in sandbox || 'ports' in sandbox) {
             if (!sandbox)
                 sandbox = {};
             if (!sandbox.name)
@@ -74,9 +76,17 @@ class SandboxInstance {
                 sandbox.image = defaultImage;
             if (!sandbox.memory)
                 sandbox.memory = defaultMemory;
+            const ports = (0, types_js_1.normalizePorts)(sandbox.ports);
             sandbox = {
                 metadata: { name: sandbox.name },
-                spec: { runtime: { image: sandbox.image, memory: sandbox.memory, generation: "mk3" } }
+                spec: {
+                    runtime: {
+                        image: sandbox.image,
+                        memory: sandbox.memory,
+                        ports: ports,
+                        generation: "mk3"
+                    }
+                }
             };
         }
         sandbox = sandbox;

package/dist/sandbox/types.d.ts

@@ -1,4 +1,4 @@
-import { Sandbox } from "../client/types.gen";
+import { Port, Sandbox } from "../client/types.gen";
 export interface SessionCreateOptions {
     expiresAt?: Date;
     responseHeaders?: Record<string, string>;
@@ -19,4 +19,6 @@ export type SandboxCreateConfiguration = {
     name?: string;
     image?: string;
     memory?: number;
+    ports?: (Port | Record<string, any>)[];
 };
+export declare function normalizePorts(ports?: (Port | Record<string, any>)[]): Port[] | undefined;

package/dist/sandbox/types.js

@@ -1,2 +1,29 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizePorts = normalizePorts;
+function normalizePorts(ports) {
+    if (!ports || ports.length === 0) {
+        return undefined;
+    }
+    const portObjects = [];
+    for (const port of ports) {
+        if (typeof port === 'object' && port !== null) {
+            if ('name' in port || 'target' in port || 'protocol' in port) {
+                // It's a Port-like object, ensure protocol defaults to HTTP
+                const normalizedPort = {
+                    name: typeof port.name === 'string' ? port.name : undefined,
+                    target: typeof port.target === 'number' ? port.target : undefined,
+                    protocol: typeof port.protocol === 'string' ? port.protocol : "HTTP"
+                };
+                portObjects.push(normalizedPort);
+            }
+            else {
+                throw new Error(`Invalid port type: ${typeof port}. Expected Port object or object with port properties.`);
+            }
+        }
+        else {
+            throw new Error(`Invalid port type: ${typeof port}. Expected Port object or object with port properties.`);
+        }
+    }
+    return portObjects;
+}

package/dist/telemetry/telemetry.d.ts

@@ -20,7 +20,7 @@ export interface BlaxelSpan {
     /** Record an error on the span */
     recordException(error: Error): void;
     /** Set the status of the span */
-    setStatus(status: 'ok' | 'error', message?: string): void;
+    setStatus(status: "ok" | "error", message?: string): void;
     /** End the span */
     end(): void;
     /** Get the span context (for passing to child spans) */
@@ -34,22 +34,15 @@ export interface BlaxelTelemetryProvider {
     startSpan(name: string, options?: BlaxelSpanOptions): BlaxelSpan;
     /** Flush the telemetry provider */
     flush(): Promise<void>;
+    /** Extract context from headers for manual context propagation */
+    extractContextFromHeaders?(headers: Record<string, string | string[]>): unknown;
 }
 /**
- * Registry for managing the global telemetry provider
+ * Registry for telemetry providers
  */
 declare class TelemetryRegistry {
-    private static instance;
     private provider;
-    private constructor();
-    static getInstance(): TelemetryRegistry;
-    /**
-     * Register a telemetry provider implementation
-     */
     registerProvider(provider: BlaxelTelemetryProvider): void;
-    /**
-     * Get the current telemetry provider
-     */
     getProvider(): BlaxelTelemetryProvider;
 }
 export declare const telemetryRegistry: TelemetryRegistry;
@@ -58,5 +51,18 @@ export declare const telemetryRegistry: TelemetryRegistry;
  */
 export declare function startSpan(name: string, options?: BlaxelSpanOptions): BlaxelSpan;
 export declare function withSpan<T>(name: string, fn: () => Promise<T>, options?: BlaxelSpanOptions): Promise<T>;
+/**
+ * Extract context from headers - useful for manual context propagation
+ * when you have traceparent headers but no active span
+ */
+export declare function extractContextFromHeaders(headers: Record<string, string | string[]>): unknown;
+/**
+ * Create a span with extracted context from headers
+ * This is useful when you need to manually establish trace context
+ */
+export declare function startSpanWithHeaders(name: string, headers: Record<string, string | string[]>, options?: Omit<BlaxelSpanOptions, "parentContext">): BlaxelSpan;
+/**
+ * Flush the telemetry provider
+ */
 export declare function flush(): Promise<void>;
 export {};

package/dist/telemetry/telemetry.js

@@ -4,6 +4,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.telemetryRegistry = void 0;
 exports.startSpan = startSpan;
 exports.withSpan = withSpan;
+exports.extractContextFromHeaders = extractContextFromHeaders;
+exports.startSpanWithHeaders = startSpanWithHeaders;
 exports.flush = flush;
 /**
  * No-operation implementation of Span
@@ -14,7 +16,9 @@ class NoopSpan {
     recordException() { }
     setStatus() { }
     end() { }
-    getContext() { return null; }
+    getContext() {
+        return null;
+    }
 }
 /**
  * No-operation implementation of TelemetryProvider
@@ -23,38 +27,25 @@ class NoopTelemetryProvider {
     startSpan() {
         return new NoopSpan();
     }
-    flush() {
-        return Promise.resolve();
+    async flush() { }
+    extractContextFromHeaders() {
+        return null;
     }
 }
 /**
- * Registry for managing the global telemetry provider
+ * Registry for telemetry providers
  */
 class TelemetryRegistry {
-    static instance;
     provider = new NoopTelemetryProvider();
-    constructor() { }
-    static getInstance() {
-        if (!TelemetryRegistry.instance) {
-            TelemetryRegistry.instance = new TelemetryRegistry();
-        }
-        return TelemetryRegistry.instance;
-    }
-    /**
-     * Register a telemetry provider implementation
-     */
     registerProvider(provider) {
         this.provider = provider;
     }
-    /**
-     * Get the current telemetry provider
-     */
     getProvider() {
         return this.provider;
     }
 }
-// Export singleton instance
-exports.telemetryRegistry = TelemetryRegistry.getInstance();
+// Global instance
+exports.telemetryRegistry = new TelemetryRegistry();
 // Convenience functions that delegate to the provider
 /**
  * Create a span with the registered provider
@@ -75,6 +66,31 @@ async function withSpan(name, fn, options) {
         throw error;
     }
 }
+/**
+ * Extract context from headers - useful for manual context propagation
+ * when you have traceparent headers but no active span
+ */
+function extractContextFromHeaders(headers) {
+    const provider = exports.telemetryRegistry.getProvider();
+    if (provider.extractContextFromHeaders) {
+        return provider.extractContextFromHeaders(headers);
+    }
+    return null;
+}
+/**
+ * Create a span with extracted context from headers
+ * This is useful when you need to manually establish trace context
+ */
+function startSpanWithHeaders(name, headers, options) {
+    const extractedContext = extractContextFromHeaders(headers);
+    return startSpan(name, {
+        ...options,
+        parentContext: extractedContext || undefined,
+    });
+}
+/**
+ * Flush the telemetry provider
+ */
 async function flush() {
-    await exports.telemetryRegistry.getProvider().flush();
+    return exports.telemetryRegistry.getProvider().flush();
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blaxel/core",
-  "version": "0.2.18",
+  "version": "0.2.19-dev.158",
   "description": "Blaxel Core SDK for TypeScript",
   "license": "MIT",
   "author": "Blaxel, INC (https://blaxel.ai)",