@layr-labs/ecloud-sdk 0.2.2-dev → 0.3.0-dev

package/dist/browser.d.cts

@@ -1,7 +1,7 @@
-import { A as AppId } from './index-DeQzn_yM.cjs';
-export { al as AlreadyActiveResponse, w as AppConfig, ac as AppProfile, ad as AppProfileResponse, a2 as AppRecord, K as BatchedDeployResult, a5 as BillingEnvironmentConfig, C as CalculateAppIDOptions, aq as CancelResponse, ao as CancelSuccessResponse, af as ChainID, ak as CheckoutCreatedResponse, ai as CreateSubscriptionOptions, aj as CreateSubscriptionResponse, D as DeployAppOptions, N as DeployAppOpts, a3 as DeployOptions, at as DeployProgressCallback, a4 as DeployResult, au as DeployStep, aa as DockerImageConfig, a6 as EnvironmentConfig, E as EstimateGasOptions, J as ExecuteDeployBatchedOptions, X as ExecuteDeployResult, H as ExecuteDeploySequentialOptions, Y as ExecuteUpgradeResult, G as GasEstimate, W as GasOpts, a9 as ImageDigestResult, I as IsDelegatedOptions, a1 as LifecycleOpts, ab as Logger, ap as NoActiveSubscriptionResponse, a8 as ParsedEnvironment, am as PaymentIssueResponse, P as PrepareDeployBatchOptions, T as PrepareDeployFromVerifiableBuildOpts, Q as PrepareDeployOpts, x as PrepareUpgradeBatchOptions, V as PrepareUpgradeFromVerifiableBuildOpts, R as PrepareUpgradeOpts, $ as PreparedDeploy, y as PreparedDeployBatch, Z as PreparedDeployData, a0 as PreparedUpgrade, z as PreparedUpgradeBatch, _ as PreparedUpgradeData, ae as ProductID, ar as ProductSubscriptionResponse, a7 as Release, S as SendTransactionOptions, av as SequentialDeployResult, an as SubscribeResponse, ah as SubscriptionLineItem, as as SubscriptionOpts, ag as SubscriptionStatus, B as SuspendOptions, F as UndelegateOptions, U as UpgradeAppOptions, O as UpgradeAppOpts, j as calculateAppID, i as deployApp, e as estimateTransactionGas, h as executeDeployBatch, l as executeDeployBatched, k as executeDeploySequential, o as executeUpgradeBatch, f as formatETH, c as getActiveAppCount, g as getAllAppsByDeveloper, a as getAppsByCreator, b as getAppsByDeveloper, d as getMaxActiveAppsPerUser, r as isDelegated, M as logVisibility, L as noopLogger, p as prepareDeployBatch, n as prepareUpgradeBatch, q as sendAndWaitForTransaction, m as supportsEIP5792, s as supportsEIP7702, t as suspend, v as undelegate, u as upgradeApp } from './index-DeQzn_yM.cjs';
-import { C as ComputeApiConfig, S as SessionInfo, a as SessionError, b as SiweMessageParams } from './helpers-CEvhJz7f.cjs';
-export { F as AppInfo, J as AppInfoResponse, I as AppMetrics, H as AppProfileInfo, K as BillingApiClient, z as CreateAppParams, P as EstimateBatchGasOptions, Q as ExecuteBatchOptions, R as Execution, G as GeneratedKey, L as LogVisibility, a3 as LoginRequest, a2 as LoginResult, A as LogsParams, Z as SiweMessageResult, U as UserApiClient, E as UserApiClientOptions, a5 as addHexPrefix, j as assertValidImageReference, n as assertValidPrivateKey, O as checkERC7702Delegation, T as createSiweMessage, M as estimateBatchGas, N as executeBatch, k as extractAppNameFromImage, D as generateNewPrivateKey, W as generateNonce, d as getAvailableEnvironments, c as getBillingEnvironmentConfig, e as getBuildType, a4 as getChainFromID, a0 as getComputeApiSession, g as getEnvironmentConfig, i as isEnvironmentAvailable, f as isMainnet, a1 as isSessionValid, X as isSiweMessageExpired, Y as isSiweMessageNotYetValid, B as isSubscriptionActive, _ as loginToComputeApi, $ as logoutFromComputeApi, V as parseSiweMessage, t as sanitizeString, u as sanitizeURL, w as sanitizeXURL, a6 as stripHexPrefix, r as validateAppID, v as validateAppName, x as validateCreateAppParams, q as validateDescription, h as validateImageReference, l as validateInstanceTypeSKU, s as validateLogVisibility, y as validateLogsParams, m as validatePrivateKeyFormat, o as validateURL, p as validateXURL } from './helpers-CEvhJz7f.cjs';
+import { A as AppId } from './index-C0w92tCs.cjs';
+export { al as AlreadyActiveResponse, w as AppConfig, ac as AppProfile, ad as AppProfileResponse, a2 as AppRecord, K as BatchedDeployResult, a5 as BillingEnvironmentConfig, C as CalculateAppIDOptions, aq as CancelResponse, ao as CancelSuccessResponse, af as ChainID, ak as CheckoutCreatedResponse, ai as CreateSubscriptionOptions, aj as CreateSubscriptionResponse, D as DeployAppOptions, N as DeployAppOpts, a3 as DeployOptions, at as DeployProgressCallback, a4 as DeployResult, au as DeployStep, aa as DockerImageConfig, a6 as EnvironmentConfig, E as EstimateGasOptions, J as ExecuteDeployBatchedOptions, X as ExecuteDeployResult, H as ExecuteDeploySequentialOptions, Y as ExecuteUpgradeResult, G as GasEstimate, W as GasOpts, a9 as ImageDigestResult, I as IsDelegatedOptions, a1 as LifecycleOpts, ab as Logger, ap as NoActiveSubscriptionResponse, a8 as ParsedEnvironment, am as PaymentIssueResponse, P as PrepareDeployBatchOptions, T as PrepareDeployFromVerifiableBuildOpts, Q as PrepareDeployOpts, x as PrepareUpgradeBatchOptions, V as PrepareUpgradeFromVerifiableBuildOpts, R as PrepareUpgradeOpts, $ as PreparedDeploy, y as PreparedDeployBatch, Z as PreparedDeployData, a0 as PreparedUpgrade, z as PreparedUpgradeBatch, _ as PreparedUpgradeData, ae as ProductID, ar as ProductSubscriptionResponse, a7 as Release, S as SendTransactionOptions, av as SequentialDeployResult, an as SubscribeResponse, ah as SubscriptionLineItem, as as SubscriptionOpts, ag as SubscriptionStatus, B as SuspendOptions, F as UndelegateOptions, U as UpgradeAppOptions, O as UpgradeAppOpts, j as calculateAppID, i as deployApp, e as estimateTransactionGas, h as executeDeployBatch, l as executeDeployBatched, k as executeDeploySequential, o as executeUpgradeBatch, f as formatETH, c as getActiveAppCount, g as getAllAppsByDeveloper, a as getAppsByCreator, b as getAppsByDeveloper, d as getMaxActiveAppsPerUser, r as isDelegated, M as logVisibility, L as noopLogger, p as prepareDeployBatch, n as prepareUpgradeBatch, q as sendAndWaitForTransaction, m as supportsEIP5792, s as supportsEIP7702, t as suspend, v as undelegate, u as upgradeApp } from './index-C0w92tCs.cjs';
+import { C as ComputeApiConfig, S as SessionInfo, a as SessionError, b as SiweMessageParams } from './helpers-Dk0zwgms.cjs';
+export { F as AppInfo, J as AppInfoResponse, I as AppMetrics, H as AppProfileInfo, K as BillingApiClient, M as BillingApiClientOptions, ac as BillingApiConfig, af as BillingLoginRequest, ae as BillingLoginResult, ab as BillingSessionError, ad as BillingSessionInfo, z as CreateAppParams, Q as EstimateBatchGasOptions, R as ExecuteBatchOptions, T as Execution, G as GeneratedKey, L as LogVisibility, a4 as LoginRequest, a3 as LoginResult, A as LogsParams, _ as SiweMessageResult, U as UserApiClient, E as UserApiClientOptions, ah as addHexPrefix, j as assertValidImageReference, n as assertValidPrivateKey, P as checkERC7702Delegation, V as createSiweMessage, N as estimateBatchGas, O as executeBatch, k as extractAppNameFromImage, D as generateNewPrivateKey, X as generateNonce, d as getAvailableEnvironments, a7 as getBillingApiSession, c as getBillingEnvironmentConfig, e as getBuildType, ag as getChainFromID, a1 as getComputeApiSession, g as getEnvironmentConfig, a8 as isBillingSessionValid, i as isEnvironmentAvailable, f as isMainnet, a2 as isSessionValid, Y as isSiweMessageExpired, Z as isSiweMessageNotYetValid, B as isSubscriptionActive, a5 as loginToBillingApi, a9 as loginToBothApis, $ as loginToComputeApi, a6 as logoutFromBillingApi, aa as logoutFromBothApis, a0 as logoutFromComputeApi, W as parseSiweMessage, t as sanitizeString, u as sanitizeURL, w as sanitizeXURL, ai as stripHexPrefix, r as validateAppID, v as validateAppName, x as validateCreateAppParams, q as validateDescription, h as validateImageReference, l as validateInstanceTypeSKU, s as validateLogVisibility, y as validateLogsParams, m as validatePrivateKeyFormat, o as validateURL, p as validateXURL } from './helpers-Dk0zwgms.cjs';
 import { WalletClient, Address, Hex } from 'viem';
 import { Buffer as Buffer$1 } from 'buffer';
 
@@ -11,19 +11,42 @@ import { Buffer as Buffer$1 } from 'buffer';
  * This is a standalone HTTP client that talks to the (compute) UserAPI host.
  */
 
+interface BuildApiClientOptions {
+    baseUrl: string;
+    walletClient?: WalletClient;
+    clientId?: string;
+    /** Use session-based auth (cookies) instead of signature-based auth */
+    useSession?: boolean;
+    /**
+     * Billing session ID (value of the billing_session cookie).
+     * When provided with useSession=true, this is sent via X-Billing-Session header
+     * to authenticate with the billing API for subscription verification.
+     * Required for submitBuild when using session auth.
+     */
+    billingSessionId?: string;
+}
 declare class BuildApiClient {
     private readonly baseUrl;
     private readonly walletClient?;
     private readonly clientId?;
-    constructor(options: {
-        baseUrl: string;
-        walletClient?: WalletClient;
-        clientId?: string;
-    });
+    private readonly useSession;
+    private billingSessionId?;
+    constructor(options: BuildApiClientOptions);
+    /**
+     * Update the billing session ID.
+     * Call this after logging into the billing API to enable session-based auth for builds.
+     */
+    setBillingSessionId(sessionId: string | undefined): void;
     /**
      * Get the address of the connected wallet
      */
     get address(): Address;
+    /**
+     * Submit a new build request.
+     * Supports two auth modes (session auth is tried first when billingSessionId is available):
+     * 1. Session-based auth: X-Billing-Session header (forwarded billing_session cookie)
+     * 2. Signature-based auth: Authorization + X-Account + X-eigenx-expiry headers (requires walletClient)
+     */
     submitBuild(payload: {
         repo_url: string;
         git_ref: string;
@@ -37,6 +60,9 @@ declare class BuildApiClient {
     getBuild(buildId: string): Promise<any>;
     getBuildByDigest(digest: string): Promise<any>;
     verify(identifier: string): Promise<any>;
+    /**
+     * Get build logs. Supports session auth (identity verification only, no billing check).
+     */
     getLogs(buildId: string): Promise<string>;
     listBuilds(params: {
         billing_address: string;
@@ -44,8 +70,23 @@ declare class BuildApiClient {
         offset?: number;
     }): Promise<any[]>;
     private publicJsonRequest;
-    private authenticatedJsonRequest;
-    private authenticatedTextRequest;
+    /**
+     * Make a request that ALWAYS requires signature auth (for billing verification).
+     * Used for endpoints like POST /builds that need to verify subscription status.
+     */
+    private signatureAuthJsonRequest;
+    /**
+     * Make a request using billing session auth (for billing verification without wallet signature).
+     * Forwards the billing_session cookie value via X-Billing-Session header.
+     * Used for endpoints that need to verify subscription status when using session-based auth.
+     */
+    private billingSessionAuthJsonRequest;
+    /**
+     * Make an authenticated request that can use session OR signature auth.
+     * When useSession is true, relies on cookies for identity verification.
+     * Used for endpoints that only need identity verification (not billing).
+     */
+    private sessionOrSignatureTextRequest;
 }
 
 /**
@@ -236,4 +277,4 @@ declare function getKMSKeysForEnvironment(environment: string, build?: BuildType
 
 type Environment = "sepolia" | "sepolia-dev" | "mainnet-alpha";
 
-export { AppId, BuildApiClient, ComputeApiConfig, type Environment, SessionError, SessionInfo, SiweMessageParams, type UseComputeSessionConfig, type UseComputeSessionReturn, encodeStartAppData, encodeStopAppData, encodeTerminateAppData, encryptRSAOAEPAndAES256GCM, getAppProtectedHeaders, getKMSKeysForEnvironment, useComputeSession };
+export { AppId, BuildApiClient, type BuildApiClientOptions, ComputeApiConfig, type Environment, SessionError, SessionInfo, SiweMessageParams, type UseComputeSessionConfig, type UseComputeSessionReturn, encodeStartAppData, encodeStopAppData, encodeTerminateAppData, encryptRSAOAEPAndAES256GCM, getAppProtectedHeaders, getKMSKeysForEnvironment, useComputeSession };

package/dist/browser.d.ts

@@ -1,7 +1,7 @@
-import { A as AppId } from './index-DeQzn_yM.js';
-export { al as AlreadyActiveResponse, w as AppConfig, ac as AppProfile, ad as AppProfileResponse, a2 as AppRecord, K as BatchedDeployResult, a5 as BillingEnvironmentConfig, C as CalculateAppIDOptions, aq as CancelResponse, ao as CancelSuccessResponse, af as ChainID, ak as CheckoutCreatedResponse, ai as CreateSubscriptionOptions, aj as CreateSubscriptionResponse, D as DeployAppOptions, N as DeployAppOpts, a3 as DeployOptions, at as DeployProgressCallback, a4 as DeployResult, au as DeployStep, aa as DockerImageConfig, a6 as EnvironmentConfig, E as EstimateGasOptions, J as ExecuteDeployBatchedOptions, X as ExecuteDeployResult, H as ExecuteDeploySequentialOptions, Y as ExecuteUpgradeResult, G as GasEstimate, W as GasOpts, a9 as ImageDigestResult, I as IsDelegatedOptions, a1 as LifecycleOpts, ab as Logger, ap as NoActiveSubscriptionResponse, a8 as ParsedEnvironment, am as PaymentIssueResponse, P as PrepareDeployBatchOptions, T as PrepareDeployFromVerifiableBuildOpts, Q as PrepareDeployOpts, x as PrepareUpgradeBatchOptions, V as PrepareUpgradeFromVerifiableBuildOpts, R as PrepareUpgradeOpts, $ as PreparedDeploy, y as PreparedDeployBatch, Z as PreparedDeployData, a0 as PreparedUpgrade, z as PreparedUpgradeBatch, _ as PreparedUpgradeData, ae as ProductID, ar as ProductSubscriptionResponse, a7 as Release, S as SendTransactionOptions, av as SequentialDeployResult, an as SubscribeResponse, ah as SubscriptionLineItem, as as SubscriptionOpts, ag as SubscriptionStatus, B as SuspendOptions, F as UndelegateOptions, U as UpgradeAppOptions, O as UpgradeAppOpts, j as calculateAppID, i as deployApp, e as estimateTransactionGas, h as executeDeployBatch, l as executeDeployBatched, k as executeDeploySequential, o as executeUpgradeBatch, f as formatETH, c as getActiveAppCount, g as getAllAppsByDeveloper, a as getAppsByCreator, b as getAppsByDeveloper, d as getMaxActiveAppsPerUser, r as isDelegated, M as logVisibility, L as noopLogger, p as prepareDeployBatch, n as prepareUpgradeBatch, q as sendAndWaitForTransaction, m as supportsEIP5792, s as supportsEIP7702, t as suspend, v as undelegate, u as upgradeApp } from './index-DeQzn_yM.js';
-import { C as ComputeApiConfig, S as SessionInfo, a as SessionError, b as SiweMessageParams } from './helpers-CQuBwQnu.js';
-export { F as AppInfo, J as AppInfoResponse, I as AppMetrics, H as AppProfileInfo, K as BillingApiClient, z as CreateAppParams, P as EstimateBatchGasOptions, Q as ExecuteBatchOptions, R as Execution, G as GeneratedKey, L as LogVisibility, a3 as LoginRequest, a2 as LoginResult, A as LogsParams, Z as SiweMessageResult, U as UserApiClient, E as UserApiClientOptions, a5 as addHexPrefix, j as assertValidImageReference, n as assertValidPrivateKey, O as checkERC7702Delegation, T as createSiweMessage, M as estimateBatchGas, N as executeBatch, k as extractAppNameFromImage, D as generateNewPrivateKey, W as generateNonce, d as getAvailableEnvironments, c as getBillingEnvironmentConfig, e as getBuildType, a4 as getChainFromID, a0 as getComputeApiSession, g as getEnvironmentConfig, i as isEnvironmentAvailable, f as isMainnet, a1 as isSessionValid, X as isSiweMessageExpired, Y as isSiweMessageNotYetValid, B as isSubscriptionActive, _ as loginToComputeApi, $ as logoutFromComputeApi, V as parseSiweMessage, t as sanitizeString, u as sanitizeURL, w as sanitizeXURL, a6 as stripHexPrefix, r as validateAppID, v as validateAppName, x as validateCreateAppParams, q as validateDescription, h as validateImageReference, l as validateInstanceTypeSKU, s as validateLogVisibility, y as validateLogsParams, m as validatePrivateKeyFormat, o as validateURL, p as validateXURL } from './helpers-CQuBwQnu.js';
+import { A as AppId } from './index-C0w92tCs.js';
+export { al as AlreadyActiveResponse, w as AppConfig, ac as AppProfile, ad as AppProfileResponse, a2 as AppRecord, K as BatchedDeployResult, a5 as BillingEnvironmentConfig, C as CalculateAppIDOptions, aq as CancelResponse, ao as CancelSuccessResponse, af as ChainID, ak as CheckoutCreatedResponse, ai as CreateSubscriptionOptions, aj as CreateSubscriptionResponse, D as DeployAppOptions, N as DeployAppOpts, a3 as DeployOptions, at as DeployProgressCallback, a4 as DeployResult, au as DeployStep, aa as DockerImageConfig, a6 as EnvironmentConfig, E as EstimateGasOptions, J as ExecuteDeployBatchedOptions, X as ExecuteDeployResult, H as ExecuteDeploySequentialOptions, Y as ExecuteUpgradeResult, G as GasEstimate, W as GasOpts, a9 as ImageDigestResult, I as IsDelegatedOptions, a1 as LifecycleOpts, ab as Logger, ap as NoActiveSubscriptionResponse, a8 as ParsedEnvironment, am as PaymentIssueResponse, P as PrepareDeployBatchOptions, T as PrepareDeployFromVerifiableBuildOpts, Q as PrepareDeployOpts, x as PrepareUpgradeBatchOptions, V as PrepareUpgradeFromVerifiableBuildOpts, R as PrepareUpgradeOpts, $ as PreparedDeploy, y as PreparedDeployBatch, Z as PreparedDeployData, a0 as PreparedUpgrade, z as PreparedUpgradeBatch, _ as PreparedUpgradeData, ae as ProductID, ar as ProductSubscriptionResponse, a7 as Release, S as SendTransactionOptions, av as SequentialDeployResult, an as SubscribeResponse, ah as SubscriptionLineItem, as as SubscriptionOpts, ag as SubscriptionStatus, B as SuspendOptions, F as UndelegateOptions, U as UpgradeAppOptions, O as UpgradeAppOpts, j as calculateAppID, i as deployApp, e as estimateTransactionGas, h as executeDeployBatch, l as executeDeployBatched, k as executeDeploySequential, o as executeUpgradeBatch, f as formatETH, c as getActiveAppCount, g as getAllAppsByDeveloper, a as getAppsByCreator, b as getAppsByDeveloper, d as getMaxActiveAppsPerUser, r as isDelegated, M as logVisibility, L as noopLogger, p as prepareDeployBatch, n as prepareUpgradeBatch, q as sendAndWaitForTransaction, m as supportsEIP5792, s as supportsEIP7702, t as suspend, v as undelegate, u as upgradeApp } from './index-C0w92tCs.js';
+import { C as ComputeApiConfig, S as SessionInfo, a as SessionError, b as SiweMessageParams } from './helpers-4w0Iojmm.js';
+export { F as AppInfo, J as AppInfoResponse, I as AppMetrics, H as AppProfileInfo, K as BillingApiClient, M as BillingApiClientOptions, ac as BillingApiConfig, af as BillingLoginRequest, ae as BillingLoginResult, ab as BillingSessionError, ad as BillingSessionInfo, z as CreateAppParams, Q as EstimateBatchGasOptions, R as ExecuteBatchOptions, T as Execution, G as GeneratedKey, L as LogVisibility, a4 as LoginRequest, a3 as LoginResult, A as LogsParams, _ as SiweMessageResult, U as UserApiClient, E as UserApiClientOptions, ah as addHexPrefix, j as assertValidImageReference, n as assertValidPrivateKey, P as checkERC7702Delegation, V as createSiweMessage, N as estimateBatchGas, O as executeBatch, k as extractAppNameFromImage, D as generateNewPrivateKey, X as generateNonce, d as getAvailableEnvironments, a7 as getBillingApiSession, c as getBillingEnvironmentConfig, e as getBuildType, ag as getChainFromID, a1 as getComputeApiSession, g as getEnvironmentConfig, a8 as isBillingSessionValid, i as isEnvironmentAvailable, f as isMainnet, a2 as isSessionValid, Y as isSiweMessageExpired, Z as isSiweMessageNotYetValid, B as isSubscriptionActive, a5 as loginToBillingApi, a9 as loginToBothApis, $ as loginToComputeApi, a6 as logoutFromBillingApi, aa as logoutFromBothApis, a0 as logoutFromComputeApi, W as parseSiweMessage, t as sanitizeString, u as sanitizeURL, w as sanitizeXURL, ai as stripHexPrefix, r as validateAppID, v as validateAppName, x as validateCreateAppParams, q as validateDescription, h as validateImageReference, l as validateInstanceTypeSKU, s as validateLogVisibility, y as validateLogsParams, m as validatePrivateKeyFormat, o as validateURL, p as validateXURL } from './helpers-4w0Iojmm.js';
 import { WalletClient, Address, Hex } from 'viem';
 import { Buffer as Buffer$1 } from 'buffer';
 
@@ -11,19 +11,42 @@ import { Buffer as Buffer$1 } from 'buffer';
  * This is a standalone HTTP client that talks to the (compute) UserAPI host.
  */
 
+interface BuildApiClientOptions {
+    baseUrl: string;
+    walletClient?: WalletClient;
+    clientId?: string;
+    /** Use session-based auth (cookies) instead of signature-based auth */
+    useSession?: boolean;
+    /**
+     * Billing session ID (value of the billing_session cookie).
+     * When provided with useSession=true, this is sent via X-Billing-Session header
+     * to authenticate with the billing API for subscription verification.
+     * Required for submitBuild when using session auth.
+     */
+    billingSessionId?: string;
+}
 declare class BuildApiClient {
     private readonly baseUrl;
     private readonly walletClient?;
     private readonly clientId?;
-    constructor(options: {
-        baseUrl: string;
-        walletClient?: WalletClient;
-        clientId?: string;
-    });
+    private readonly useSession;
+    private billingSessionId?;
+    constructor(options: BuildApiClientOptions);
+    /**
+     * Update the billing session ID.
+     * Call this after logging into the billing API to enable session-based auth for builds.
+     */
+    setBillingSessionId(sessionId: string | undefined): void;
     /**
      * Get the address of the connected wallet
      */
     get address(): Address;
+    /**
+     * Submit a new build request.
+     * Supports two auth modes (session auth is tried first when billingSessionId is available):
+     * 1. Session-based auth: X-Billing-Session header (forwarded billing_session cookie)
+     * 2. Signature-based auth: Authorization + X-Account + X-eigenx-expiry headers (requires walletClient)
+     */
     submitBuild(payload: {
         repo_url: string;
         git_ref: string;
@@ -37,6 +60,9 @@ declare class BuildApiClient {
     getBuild(buildId: string): Promise<any>;
     getBuildByDigest(digest: string): Promise<any>;
     verify(identifier: string): Promise<any>;
+    /**
+     * Get build logs. Supports session auth (identity verification only, no billing check).
+     */
     getLogs(buildId: string): Promise<string>;
     listBuilds(params: {
         billing_address: string;
@@ -44,8 +70,23 @@ declare class BuildApiClient {
         offset?: number;
     }): Promise<any[]>;
     private publicJsonRequest;
-    private authenticatedJsonRequest;
-    private authenticatedTextRequest;
+    /**
+     * Make a request that ALWAYS requires signature auth (for billing verification).
+     * Used for endpoints like POST /builds that need to verify subscription status.
+     */
+    private signatureAuthJsonRequest;
+    /**
+     * Make a request using billing session auth (for billing verification without wallet signature).
+     * Forwards the billing_session cookie value via X-Billing-Session header.
+     * Used for endpoints that need to verify subscription status when using session-based auth.
+     */
+    private billingSessionAuthJsonRequest;
+    /**
+     * Make an authenticated request that can use session OR signature auth.
+     * When useSession is true, relies on cookies for identity verification.
+     * Used for endpoints that only need identity verification (not billing).
+     */
+    private sessionOrSignatureTextRequest;
 }
 
 /**
@@ -236,4 +277,4 @@ declare function getKMSKeysForEnvironment(environment: string, build?: BuildType
 
 type Environment = "sepolia" | "sepolia-dev" | "mainnet-alpha";
 
-export { AppId, BuildApiClient, ComputeApiConfig, type Environment, SessionError, SessionInfo, SiweMessageParams, type UseComputeSessionConfig, type UseComputeSessionReturn, encodeStartAppData, encodeStopAppData, encodeTerminateAppData, encryptRSAOAEPAndAES256GCM, getAppProtectedHeaders, getKMSKeysForEnvironment, useComputeSession };
+export { AppId, BuildApiClient, type BuildApiClientOptions, ComputeApiConfig, type Environment, SessionError, SessionInfo, SiweMessageParams, type UseComputeSessionConfig, type UseComputeSessionReturn, encodeStartAppData, encodeStopAppData, encodeTerminateAppData, encryptRSAOAEPAndAES256GCM, getAppProtectedHeaders, getKMSKeysForEnvironment, useComputeSession };