@blaxel/core 0.2.77 → 0.2.78-preview.126

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

@@ -81,7 +81,30 @@ if (isNode && !isBrowser) {
         // Silently ignore warming failures
     }
 }
-// Allow to set custom configuration for browser environment
+/**
+ * Configure the SDK programmatically at runtime, instead of relying on
+ * environment variables or config files.
+ *
+ * @example
+ * // With an API key
+ * initialize({ workspace: 'my-workspace', apiKey: 'bl_...' });
+ *
+ * @example
+ * // With client credentials (object form)
+ * initialize({
+ *   workspace: 'my-workspace',
+ *   clientCredentials: { clientId: '...', clientSecret: '...' },
+ * });
+ * await authenticate();
+ *
+ * @example
+ * // With client credentials (pre-encoded Base64 string)
+ * initialize({
+ *   workspace: 'my-workspace',
+ *   clientCredentials: 'base64-encoded-string',
+ * });
+ * await authenticate();
+ */
 function initialize(config) {
     settings_js_1.settings.setConfig(config);
     client_gen_js_1.client.setConfig({

package/dist/cjs-browser/common/initialize.integration.test.js

@@ -0,0 +1,59 @@
+"use strict";
+/**
+ * Integration tests for programmatic SDK initialization.
+ *
+ * These tests hit the real Blaxel API and require credentials.
+ * Set the following environment variables before running:
+ *
+ *   TEST_BL_WORKSPACE        - Blaxel workspace name
+ *   TEST_BL_API_KEY          - API key (for apiKey test)
+ *   TEST_BL_CLIENT_CREDS     - Base64-encoded client credentials (for string test)
+ *   TEST_BL_CLIENT_ID        - Client ID (for object test)
+ *   TEST_BL_CLIENT_SECRET    - Client secret (for object test)
+ *
+ * Run with:
+ *   TEST_BL_WORKSPACE=... TEST_BL_API_KEY=... npx vitest --run src/common/initialize.integration.test.ts
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const sdk_gen_js_1 = require("../client/sdk.gen.js");
+const autoload_js_1 = require("./autoload.js");
+const workspace = process.env.TEST_BL_WORKSPACE;
+vitest_1.describe.runIf(workspace)("initialize() integration", () => {
+    (0, vitest_1.it)("works with apiKey", async () => {
+        const apiKey = process.env.TEST_BL_API_KEY;
+        if (!apiKey)
+            return;
+        (0, autoload_js_1.initialize)({ workspace: workspace, apiKey });
+        const res = await (0, sdk_gen_js_1.listWorkspaces)();
+        (0, vitest_1.expect)(res.error).toBeUndefined();
+        (0, vitest_1.expect)(res.data).toBeDefined();
+        (0, vitest_1.expect)(Array.isArray(res.data)).toBe(true);
+    });
+    (0, vitest_1.it)("works with clientCredentials as Base64 string", async () => {
+        const clientCredentials = process.env.TEST_BL_CLIENT_CREDS;
+        if (!clientCredentials)
+            return;
+        (0, autoload_js_1.initialize)({ workspace: workspace, clientCredentials });
+        await (0, autoload_js_1.authenticate)();
+        const res = await (0, sdk_gen_js_1.listWorkspaces)();
+        (0, vitest_1.expect)(res.error).toBeUndefined();
+        (0, vitest_1.expect)(res.data).toBeDefined();
+        (0, vitest_1.expect)(Array.isArray(res.data)).toBe(true);
+    });
+    (0, vitest_1.it)("works with clientCredentials as { clientId, clientSecret }", async () => {
+        const clientId = process.env.TEST_BL_CLIENT_ID;
+        const clientSecret = process.env.TEST_BL_CLIENT_SECRET;
+        if (!clientId || !clientSecret)
+            return;
+        (0, autoload_js_1.initialize)({
+            workspace: workspace,
+            clientCredentials: { clientId, clientSecret },
+        });
+        await (0, autoload_js_1.authenticate)();
+        const res = await (0, sdk_gen_js_1.listWorkspaces)();
+        (0, vitest_1.expect)(res.error).toBeUndefined();
+        (0, vitest_1.expect)(res.data).toBeDefined();
+        (0, vitest_1.expect)(Array.isArray(res.data)).toBe(true);
+    });
+});

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

@@ -5,12 +5,14 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.settings = void 0;
 const yaml_1 = __importDefault(require("yaml"));
+const apikey_js_1 = require("../authentication/apikey.js");
+const clientcredentials_js_1 = require("../authentication/clientcredentials.js");
 const index_js_1 = require("../authentication/index.js");
 const env_js_1 = require("../common/env.js");
 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.77";
-const BUILD_COMMIT = "3d5932081fba211232402513e9765d0a776cd5d4";
+const BUILD_VERSION = "0.2.78-preview.126";
+const BUILD_COMMIT = "d2c4fbf20e9777ddc3e8fb2d58f9e021b860e986";
 const BUILD_SENTRY_DSN = "https://fd5e60e1c9820e1eef5ccebb84a07127@o4508714045276160.ingest.us.sentry.io/4510465864564736";
 // Cache for config.yaml tracking value
 let configTrackingValue = null;
@@ -82,6 +84,21 @@ class Settings {
     }
     setConfig(config) {
         this.config = config;
+        if (config.apiKey) {
+            this.credentials = new apikey_js_1.ApiKey({
+                apiKey: config.apiKey,
+                workspace: config.workspace,
+            });
+        }
+        else if (config.clientCredentials) {
+            const encoded = typeof config.clientCredentials === 'string'
+                ? config.clientCredentials
+                : btoa(`${config.clientCredentials.clientId}:${config.clientCredentials.clientSecret}`);
+            this.credentials = new clientcredentials_js_1.ClientCredentials({
+                clientCredentials: encoded,
+                workspace: config.workspace,
+            });
+        }
     }
     get env() {
         return env_js_1.env.BL_ENV || "prod";

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

@@ -1,4 +1,28 @@
 import { Config } from "./settings.js";
+/**
+ * Configure the SDK programmatically at runtime, instead of relying on
+ * environment variables or config files.
+ *
+ * @example
+ * // With an API key
+ * initialize({ workspace: 'my-workspace', apiKey: 'bl_...' });
+ *
+ * @example
+ * // With client credentials (object form)
+ * initialize({
+ *   workspace: 'my-workspace',
+ *   clientCredentials: { clientId: '...', clientSecret: '...' },
+ * });
+ * await authenticate();
+ *
+ * @example
+ * // With client credentials (pre-encoded Base64 string)
+ * initialize({
+ *   workspace: 'my-workspace',
+ *   clientCredentials: 'base64-encoded-string',
+ * });
+ * await authenticate();
+ */
 export declare function initialize(config: Config): void;
 export declare function authenticate(): Promise<void>;
 /**

package/dist/cjs-browser/types/common/initialize.integration.test.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Integration tests for programmatic SDK initialization.
+ *
+ * These tests hit the real Blaxel API and require credentials.
+ * Set the following environment variables before running:
+ *
+ *   TEST_BL_WORKSPACE        - Blaxel workspace name
+ *   TEST_BL_API_KEY          - API key (for apiKey test)
+ *   TEST_BL_CLIENT_CREDS     - Base64-encoded client credentials (for string test)
+ *   TEST_BL_CLIENT_ID        - Client ID (for object test)
+ *   TEST_BL_CLIENT_SECRET    - Client secret (for object test)
+ *
+ * Run with:
+ *   TEST_BL_WORKSPACE=... TEST_BL_API_KEY=... npx vitest --run src/common/initialize.integration.test.ts
+ */
+export {};

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

@@ -1,8 +1,26 @@
 import { Credentials } from "../authentication/credentials.js";
+/**
+ * Client credentials as a `{ clientId, clientSecret }` pair.
+ * The SDK will Base64-encode them automatically.
+ */
+export type ClientCredentialsPair = {
+    clientId: string;
+    clientSecret: string;
+};
 export type Config = {
     proxy?: string;
     apikey?: string;
     workspace?: string;
+    /**
+     * Client credentials for OAuth2 client_credentials flow.
+     *
+     * Accepts either:
+     * - A pre-encoded Base64 string (`btoa("clientId:clientSecret")`)
+     * - An object `{ clientId, clientSecret }` (the SDK encodes it for you)
+     */
+    clientCredentials?: string | ClientCredentialsPair;
+    /** API key for bearer token authentication */
+    apiKey?: string;
 };
 declare class Settings {
     credentials: Credentials;