oblien 1.2.7 → 1.3.0

package/index.d.ts

@@ -12,7 +12,7 @@ export interface OblienConfig {
 
 export class OblienClient {
     constructor(config: OblienConfig);
-    
+
     authenticate(): Promise<string>;
     getAuthHeaders(): Promise<Record<string, string>>;
     get(path: string, params?: Record<string, any>): Promise<any>;
@@ -33,7 +33,7 @@ export interface StorageAdapter {
 
 export class NodeCacheStorage implements StorageAdapter {
     constructor(ttl?: number);
-    
+
     get(key: string): Promise<any>;
     set(key: string, value: any, ttl?: number): Promise<boolean>;
     delete(key: string): Promise<boolean>;
@@ -51,7 +51,7 @@ export class InMemoryStorage implements StorageAdapter {
 
 export class RedisStorage implements StorageAdapter {
     constructor(redisClient: any);
-    
+
     get(key: string): Promise<any>;
     set(key: string, value: any, ttl?: number): Promise<boolean>;
     delete(key: string): Promise<boolean>;
@@ -100,7 +100,7 @@ export interface Guest {
 
 export class GuestManager {
     constructor(options?: GuestManagerOptions);
-    
+
     generateGuestId(ip: string): string;
     getOrCreateGuest(ip: string, metadata?: Record<string, any>): Promise<Guest>;
     getGuest(guestId: string | GuestOptions): Promise<Guest | null>;
@@ -141,10 +141,10 @@ export interface SessionData {
 
 export class ChatSession {
     constructor(options: SessionOptions);
-    
+
     sessionId: string | null;
     token: string | null;
-    
+
     create(): Promise<SessionData>;
     get(sessionId?: string): Promise<any>;
     delete(sessionId?: string): Promise<any>;
@@ -176,7 +176,7 @@ export interface CreateGuestSessionOptions {
     fingerprint?: string;
     agentId: string;
     workflowId?: string;
-    namespace?: string; 
+    namespace?: string;
     endUserId?: string;
     metadata?: Record<string, any>;
     workspace?: Record<string, any>;
@@ -304,39 +304,39 @@ export interface GetGuestOptions {
 
 export class OblienChat {
     constructor(client: OblienClient, options?: ChatOptions);
-    
+
     // Session Creation
     createSession(options: CreateSessionOptions): Promise<SessionData>;
     createGuestSession(options: CreateGuestSessionOptions): Promise<GuestSessionData>;
     getGuest(options: GetGuestOptions | string, getSessions?: boolean): Promise<Guest | null>; // From Oblien API (string = namespace)
     getGuestFromCache(ip: string, fingerprint?: string): Promise<Guest | null>; // From local cache
-    
+
     // Session Token Management (Server-side)
     createSessionToken(sessionId: string): Promise<SessionTokenData>;
     revokeSessionToken(sessionId: string): Promise<any>;
-    
+
     // Session Token Management (Client-side)
     refreshToken(options: RefreshTokenOptions): Promise<SessionTokenData>;
     prepareSession(options: PrepareSessionOptions): Promise<any>;
-    
+
     // Session Management (Server-side)
     getSession(sessionId: string): Promise<any>;
     getSessionHistory(sessionId: string, options?: SessionHistoryOptions): Promise<any>;
     listSessions(options?: ListSessionsOptions): Promise<any[]>;
     deleteSession(sessionId: string): Promise<any>;
-    
+
     // Security & Moderation (Server-side)
     banUser(sessionId: string, options?: BanUserOptions): Promise<any>;
     unbanUser(sessionId: string): Promise<any>;
     lockSession(sessionId: string, options?: LockSessionOptions): Promise<any>;
-    
+
     // Chat Operations
     send(options: SendMessageOptions): Promise<any>;
     upload(options: UploadOptions): Promise<any>;
-    
+
     // History (Client-side)
     getHistory(options: GetHistoryOptions): Promise<any>;
-    
+
     // Guest Management
     getAllGuests(): Promise<Guest[]>;
     cleanupGuests(): Promise<number>;
@@ -441,10 +441,10 @@ export interface NamespaceUsage {
 
 export class Namespace {
     constructor(options: { client: OblienClient; namespaceId?: string; data?: NamespaceData });
-    
+
     namespaceId: string | null;
     data: NamespaceData | null;
-    
+
     create(options: CreateNamespaceOptions): Promise<NamespaceData>;
     get(identifier?: string): Promise<NamespaceData>;
     update(updates: UpdateNamespaceOptions, namespaceId?: string): Promise<NamespaceData>;
@@ -461,7 +461,7 @@ export class Namespace {
 
 export class OblienNamespaces {
     constructor(client: OblienClient);
-    
+
     create(options: CreateNamespaceOptions): Promise<NamespaceData>;
     get(identifier: string): Promise<NamespaceData>;
     list(options?: ListNamespacesOptions): Promise<{ success: boolean; data: NamespaceData[]; pagination: any }>;
@@ -606,41 +606,41 @@ export interface PurchaseHistoryOptions {
 
 export class OblienCredits {
     constructor(client: OblienClient);
-    
+
     // Balance Management
     getBalance(): Promise<number>;
     addCredits(amount: number, reason?: string, metadata?: Record<string, any>): Promise<any>;
-    
+
     // Quota Management
     getNamespaceQuotas(options?: { limit?: number; offset?: number; after?: string; search?: string; status?: string }): Promise<any>;
     getNamespaceDetails(namespace: string, options?: { days?: number }): Promise<any>;
     setQuota(options: SetQuotaOptions): Promise<QuotaData>;
     resetQuota(namespace: string, service: string): Promise<any>;
-    
+
     // End User Quota Management (Optional Third Level)
     setEndUserQuota(options: SetEndUserQuotaOptions): Promise<any>;
     getEndUserQuota(namespace: string, endUserId: string, service: string): Promise<{ success: boolean; quota: EndUserQuota | null }>;
     resetEndUserQuota(namespace: string, endUserId: string, service: string): Promise<any>;
-    
+
     // Default Quota Configuration (Dynamic, per client)
     setDefaultQuota(options: SetDefaultQuotaOptions): Promise<any>;
     getDefaultQuota(level: 'namespace' | 'end_user', service: string): Promise<{ success: boolean; config: DefaultQuotaConfig | null }>;
     getAllDefaultQuotas(level?: 'namespace' | 'end_user'): Promise<{ success: boolean; configs: DefaultQuotaConfig[] }>;
     deleteDefaultQuota(level: 'namespace' | 'end_user', service: string): Promise<any>;
     toggleDefaultQuotaAutoApply(level: 'namespace' | 'end_user', service: string, autoApply: boolean): Promise<any>;
-    
+
     // Usage History & Transactions
     getHistory(options?: HistoryOptions): Promise<{ success: boolean; data: CreditTransaction[]; pagination: any }>;
     getHistoryFilters(): Promise<{ namespaces: string[]; services: string[] }>;
     getSummary(options?: SummaryOptions): Promise<any>;
     getUsageStats(options?: { days?: number }): Promise<any>;
-    
+
     // Pricing & Packages
     getPackages(): Promise<CreditPackage[]>;
     getPricingInfo(): Promise<any>;
     calculateCost(options: CalculateCostOptions): Promise<any>;
     calculateCredits(amount: number): Promise<any>;
-    
+
     // Purchase Management
     createCheckout(options: PurchaseOptions): Promise<any>;
     getPurchaseHistory(options?: PurchaseHistoryOptions): Promise<any>;
@@ -675,7 +675,10 @@ export interface PageContentOptions {
     selector?: string;
     extract?: 'html' | 'text' | 'both';
     waitForFullLoad?: boolean;
-    useProxy?: boolean;
+    proxy?: string;
+    proxyPort?: number;
+    proxyUsername?: string;
+    proxyPassword?: string;
 }
 
 export interface PageContentResult {
@@ -694,7 +697,10 @@ export interface ScreenshotOptions {
     quality?: number;
     viewport?: { width: number; height: number };
     device?: string;
-    useProxy?: boolean;
+    proxy?: string;
+    proxyPort?: number;
+    proxyUsername?: string;
+    proxyPassword?: string;
 }
 
 export interface ScreenshotResult {
@@ -712,7 +718,10 @@ export interface PdfOptions {
     landscape?: boolean;
     printBackground?: boolean;
     margin?: { top?: string; right?: string; bottom?: string; left?: string };
-    useProxy?: boolean;
+    proxy?: string;
+    proxyPort?: number;
+    proxyUsername?: string;
+    proxyPassword?: string;
 }
 
 export interface PdfResult {
@@ -727,7 +736,10 @@ export interface MonitorRequestsOptions {
     token?: string;
     duration?: number;
     filterTypes?: string[];
-    useProxy?: boolean;
+    proxy?: string;
+    proxyPort?: number;
+    proxyUsername?: string;
+    proxyPassword?: string;
 }
 
 export interface MonitorRequestsResult {
@@ -745,7 +757,10 @@ export interface ConsoleLogsOptions {
     url: string;
     token?: string;
     duration?: number;
-    useProxy?: boolean;
+    proxy?: string;
+    proxyPort?: number;
+    proxyUsername?: string;
+    proxyPassword?: string;
 }
 
 export interface ConsoleLogsResult {
@@ -759,11 +774,11 @@ export interface ConsoleLogsResult {
 
 export class OblienBrowser {
     constructor(client: OblienClient, config?: BrowserConfig);
-    
+
     // Token Management
     generateToken(): Promise<BrowserTokenResponse>;
     clearTokenCache(): void;
-    
+
     // Browser Operations
     getPageContent(options: PageContentOptions): Promise<PageContentResult>;
     screenshot(options: ScreenshotOptions): Promise<ScreenshotResult>;
@@ -919,26 +934,26 @@ export interface RestoreFileResult {
 
 export class OblienCDN {
     constructor(client: OblienClient, config?: CDNConfig);
-    
+
     // Token Management
     generateUserToken(): Promise<TokenResponse>;
     generateAdminToken(): Promise<TokenResponse>;
     clearTokenCache(scope?: 'user' | 'admin' | 'all'): void;
-    
+
     // File Upload
     upload(file: Buffer | string | MulterFile, options?: UploadOptions): Promise<UploadResult>;
     uploadMultiple(files: Array<Buffer | string | MulterFile>, options?: MultiUploadOptions): Promise<MultiUploadResult>;
-    
+
     // URL Upload
     uploadFromUrls(urls: string[], options?: UploadFromUrlsOptions): Promise<MultiUploadResult>;
-    
+
     // File Info (Admin Only)
     getFileInfo(filePath: string, options?: FileInfoOptions): Promise<FileInfo>;
-    
+
     // Metadata
     getVariants(options?: { token?: string }): Promise<any>;
     getLimits(options?: { token?: string }): Promise<any>;
-    
+
     // File Management (Session-based)
     listFiles(options?: ListFilesOptions): Promise<ListFilesResult>;
     getStats(): Promise<StorageStats>;
@@ -947,6 +962,10 @@ export class OblienCDN {
     restoreFile(fileId: number | string): Promise<RestoreFileResult>;
 }
 
+// ============ Sandbox Types ============
+
+export * from './src/sandbox/index.d.ts';
+
 // ============ Exports ============
 
 declare const _default: {

package/index.js

@@ -13,11 +13,11 @@ import { OblienCDN } from './src/cdn/index.js';
 import { OblienBrowser } from './src/browser/index.js';
 import { OblienNamespaces, Namespace } from './src/namespaces/index.js';
 import { OblienCredits } from './src/credits/index.js';
-import { 
-    GuestManager, 
+import {
+    GuestManager,
     NodeCacheStorage,
     InMemoryStorage,
-    RedisStorage 
+    RedisStorage
 } from './src/utils/guest-manager.js';
 
 // Re-export as named exports
@@ -31,11 +31,11 @@ export { OblienCDN };
 export { OblienBrowser };
 export { OblienNamespaces, Namespace };
 export { OblienCredits };
-export { 
-    GuestManager, 
+export {
+    GuestManager,
     NodeCacheStorage,
     InMemoryStorage,
-    RedisStorage 
+    RedisStorage
 };
 
 // Default export

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oblien",
-  "version": "1.2.7",
+  "version": "1.3.0",
   "description": "Server-side SDK for Oblien AI Platform - Build AI-powered applications with chat, agents, and workflows",
   "main": "index.js",
   "type": "module",
@@ -82,4 +82,4 @@
     "README.md",
     "LICENSE"
   ]
-}
+}

package/sandbox.js

@@ -1,12 +1,12 @@
 /**
  * Sandbox Module Entry Point
- * Import this for sandbox management only
+ * Import this for sandbox management and interaction
  */
 
-export { OblienSandboxes, Sandbox } from './src/sandbox/index.js';
+export { OblienSandboxes, Sandbox, SandboxClient } from './src/sandbox/index.js';
 
-export default { 
-    OblienSandboxes, 
-    Sandbox 
+export default {
+    OblienSandboxes,
+    Sandbox,
+    SandboxClient
 };
-

package/src/agents/index.js

@@ -3,19 +3,34 @@
  * Manages AI agents, their settings, and operations
  */
 
+import { OblienClient } from '../client.js';
 import { Agent } from './agent.js';
 import { Tools } from './tools.js';
 
 export class OblienAgents {
     /**
-     * @param {import('../client.js').OblienClient} client - Oblien client instance
+     * @param {import('../client.js').OblienClient|Object} clientOrConfig - Oblien client instance or config
+     * @param {string} [clientOrConfig.clientId] - Client ID (if not using client instance)
+     * @param {string} [clientOrConfig.clientSecret] - Client Secret (if not using client instance)
+     * @param {string} [clientOrConfig.baseURL] - Base URL (optional)
      */
-    constructor(client) {
-        if (!client) {
-            throw new Error('Oblien client is required');
+    constructor(clientOrConfig) {
+        if (!clientOrConfig) {
+            throw new Error('Oblien client or credentials are required');
+        }
+
+        // If it's already a client instance
+        if (clientOrConfig.clientId && clientOrConfig.clientSecret && typeof clientOrConfig.get === 'function') {
+            this.client = clientOrConfig;
+        }
+        // If credentials provided, create client
+        else if (clientOrConfig.clientId && clientOrConfig.clientSecret) {
+            this.client = new OblienClient(clientOrConfig);
+        }
+        else {
+            throw new Error('Either provide OblienClient instance or { clientId, clientSecret }');
         }
 
-        this.client = client;
         this._tools = null;
     }
 

package/src/browser/index.js

@@ -3,12 +3,37 @@
  * Browser automation with automatic token management
  */
 
+import { OblienClient } from '../client.js';
+
 export class OblienBrowser {
-    constructor(client, config = {}) {
-        if (!client) throw new Error('Oblien client is required');
-        this.client = client;
+    /**
+     * @param {import('../client.js').OblienClient|Object} clientOrConfig - Oblien client instance or { clientId, clientSecret }
+     * @param {Object} [config] - Configuration options
+     * @param {string} [config.browserURL] - Browser service URL
+     */
+    constructor(clientOrConfig, config = {}) {
+        if (!clientOrConfig) {
+            throw new Error('Either provide OblienClient instance or { clientId, clientSecret }');
+        }
+
+        // If it's already a client instance
+        if (clientOrConfig.clientId && clientOrConfig.clientSecret && typeof clientOrConfig.get === 'function') {
+            this.client = clientOrConfig;
+        }
+        // If credentials provided, create client
+        else if (clientOrConfig.clientId && clientOrConfig.clientSecret) {
+            // Extract browserURL if passed in clientOrConfig
+            if (clientOrConfig.browserURL) {
+                config.browserURL = clientOrConfig.browserURL;
+            }
+            this.client = new OblienClient(clientOrConfig);
+        }
+        else {
+            throw new Error('Either provide OblienClient instance or { clientId, clientSecret }');
+        }
+
         this.browserURL = config.browserURL || 'https://browser.oblien.com';
-        
+
         // Token cache for reuse within expiration window
         this._tokenCache = {
             token: null,
@@ -33,7 +58,7 @@ export class OblienBrowser {
      */
     async generateToken() {
         const response = await this.client.post('browser/token');
-        
+
         // Cache token for reuse
         if (response.success && response.token) {
             this._tokenCache = {
@@ -41,7 +66,7 @@ export class OblienBrowser {
                 expiresAt: Date.now() + 50000 // 50 seconds (buffer before 1m expiry)
             };
         }
-        
+
         return response;
     }
 
@@ -52,12 +77,12 @@ export class OblienBrowser {
      */
     async _getToken() {
         const cached = this._tokenCache;
-        
+
         // Use cached token if still valid
         if (cached.token && cached.expiresAt > Date.now()) {
             return cached.token;
         }
-        
+
         // Generate new token
         const tokenData = await this.generateToken();
         return tokenData.token;
@@ -107,14 +132,14 @@ export class OblienBrowser {
      */
     async getPageContent(options) {
         const { url, token, ...restOptions } = options;
-        
+
         if (!url) {
             throw new Error('URL is required');
         }
-        
+
         // Get token (use provided or generate new one)
         const browserToken = token || await this._getToken();
-        
+
         const response = await fetch(`${this.browserURL}/page-content`, {
             method: 'POST',
             headers: {
@@ -123,12 +148,12 @@ export class OblienBrowser {
             },
             body: JSON.stringify({ url, ...restOptions })
         });
-        
+
         if (!response.ok) {
             const error = await response.json().catch(() => ({}));
             throw new Error(error.error || `Request failed: ${response.status}`);
         }
-        
+
         return response.json();
     }
 
@@ -167,13 +192,13 @@ export class OblienBrowser {
      */
     async screenshot(options) {
         const { url, token, ...restOptions } = options;
-        
+
         if (!url) {
             throw new Error('URL is required');
         }
-        
+
         const browserToken = token || await this._getToken();
-        
+
         const response = await fetch(`${this.browserURL}/screenshot`, {
             method: 'POST',
             headers: {
@@ -182,12 +207,12 @@ export class OblienBrowser {
             },
             body: JSON.stringify({ url, ...restOptions })
         });
-        
+
         if (!response.ok) {
             const error = await response.json().catch(() => ({}));
             throw new Error(error.error || `Screenshot failed: ${response.status}`);
         }
-        
+
         return response.json();
     }
 
@@ -224,13 +249,13 @@ export class OblienBrowser {
      */
     async pdf(options) {
         const { url, token, ...restOptions } = options;
-        
+
         if (!url) {
             throw new Error('URL is required');
         }
-        
+
         const browserToken = token || await this._getToken();
-        
+
         const response = await fetch(`${this.browserURL}/pdf`, {
             method: 'POST',
             headers: {
@@ -239,12 +264,12 @@ export class OblienBrowser {
             },
             body: JSON.stringify({ url, ...restOptions })
         });
-        
+
         if (!response.ok) {
             const error = await response.json().catch(() => ({}));
             throw new Error(error.error || `PDF generation failed: ${response.status}`);
         }
-        
+
         return response.json();
     }
 
@@ -280,13 +305,13 @@ export class OblienBrowser {
      */
     async monitorRequests(options) {
         const { url, token, ...restOptions } = options;
-        
+
         if (!url) {
             throw new Error('URL is required');
         }
-        
+
         const browserToken = token || await this._getToken();
-        
+
         const response = await fetch(`${this.browserURL}/monitor-requests`, {
             method: 'POST',
             headers: {
@@ -295,12 +320,12 @@ export class OblienBrowser {
             },
             body: JSON.stringify({ url, ...restOptions })
         });
-        
+
         if (!response.ok) {
             const error = await response.json().catch(() => ({}));
             throw new Error(error.error || `Request monitoring failed: ${response.status}`);
         }
-        
+
         return response.json();
     }
 
@@ -333,13 +358,13 @@ export class OblienBrowser {
      */
     async getConsoleLogs(options) {
         const { url, token, ...restOptions } = options;
-        
+
         if (!url) {
             throw new Error('URL is required');
         }
-        
+
         const browserToken = token || await this._getToken();
-        
+
         const response = await fetch(`${this.browserURL}/console-logs`, {
             method: 'POST',
             headers: {
@@ -348,12 +373,12 @@ export class OblienBrowser {
             },
             body: JSON.stringify({ url, ...restOptions })
         });
-        
+
         if (!response.ok) {
             const error = await response.json().catch(() => ({}));
             throw new Error(error.error || `Console logs retrieval failed: ${response.status}`);
         }
-        
+
         return response.json();
     }
 
@@ -377,21 +402,21 @@ export class OblienBrowser {
      */
     async getDevicePresets(options = {}) {
         const { token } = options;
-        
+
         const browserToken = token || await this._getToken();
-        
+
         const response = await fetch(`${this.browserURL}/device-presets`, {
             method: 'GET',
             headers: {
                 'Authorization': `Bearer ${browserToken}`
             }
         });
-        
+
         if (!response.ok) {
             const error = await response.json().catch(() => ({}));
             throw new Error(error.error || `Failed to get device presets: ${response.status}`);
         }
-        
+
         return response.json();
     }
 
@@ -414,21 +439,21 @@ export class OblienBrowser {
      */
     async getStatus(options = {}) {
         const { token } = options;
-        
+
         const browserToken = token || await this._getToken();
-        
+
         const response = await fetch(`${this.browserURL}/status`, {
             method: 'GET',
             headers: {
                 'Authorization': `Bearer ${browserToken}`
             }
         });
-        
+
         if (!response.ok) {
             const error = await response.json().catch(() => ({}));
             throw new Error(error.error || `Failed to get status: ${response.status}`);
         }
-        
+
         return response.json();
     }