@layr-labs/ecloud-sdk 0.1.1 → 0.2.0-dev

package/dist/chunk-LINGJMAS.js

@@ -0,0 +1,180 @@
+import {
+  addHexPrefix,
+  calculateBillingAuthSignature,
+  getBillingEnvironmentConfig,
+  getBuildType,
+  getLogger,
+  isSubscriptionActive,
+  withSDKTelemetry
+} from "./chunk-34DXGQ35.js";
+
+// src/client/common/utils/billingapi.ts
+import axios from "axios";
+import { privateKeyToAccount } from "viem/accounts";
+var BillingApiClient = class {
+  constructor(config, privateKey) {
+    this.account = privateKeyToAccount(privateKey);
+    this.config = config;
+  }
+  async createSubscription(productId = "compute") {
+    const endpoint = `${this.config.billingApiServerURL}/products/${productId}/subscription`;
+    const resp = await this.makeAuthenticatedRequest(endpoint, "POST", productId);
+    return resp.json();
+  }
+  async getSubscription(productId = "compute") {
+    const endpoint = `${this.config.billingApiServerURL}/products/${productId}/subscription`;
+    const resp = await this.makeAuthenticatedRequest(endpoint, "GET", productId);
+    return resp.json();
+  }
+  async cancelSubscription(productId = "compute") {
+    const endpoint = `${this.config.billingApiServerURL}/products/${productId}/subscription`;
+    await this.makeAuthenticatedRequest(endpoint, "DELETE", productId);
+  }
+  /**
+   * Make an authenticated request to the billing API
+   */
+  async makeAuthenticatedRequest(url, method, productId) {
+    const expiry = BigInt(Math.floor(Date.now() / 1e3) + 5 * 60);
+    const { signature } = await calculateBillingAuthSignature({
+      account: this.account,
+      product: productId,
+      expiry
+    });
+    const headers = {
+      Authorization: `Bearer ${signature}`,
+      "X-Account": this.account.address,
+      "X-Expiry": expiry.toString()
+    };
+    try {
+      const response = await axios({
+        method,
+        url,
+        headers,
+        timeout: 3e4,
+        maxRedirects: 0,
+        validateStatus: () => true
+        // Don't throw on any status
+      });
+      const status = response.status;
+      const statusText = status >= 200 && status < 300 ? "OK" : "Error";
+      if (status < 200 || status >= 300) {
+        const body = typeof response.data === "string" ? response.data : JSON.stringify(response.data);
+        throw new Error(`BillingAPI request failed: ${status} ${statusText} - ${body}`);
+      }
+      return {
+        json: async () => response.data,
+        text: async () => typeof response.data === "string" ? response.data : JSON.stringify(response.data)
+      };
+    } catch (error) {
+      if (error.message?.includes("fetch failed") || error.message?.includes("ECONNREFUSED") || error.message?.includes("ENOTFOUND") || error.cause) {
+        const cause = error.cause?.message || error.cause || error.message;
+        throw new Error(
+          `Failed to connect to BillingAPI at ${url}: ${cause}
+Please check:
+1. Your internet connection
+2. The API server is accessible: ${this.config.billingApiServerURL}
+3. Firewall/proxy settings`
+        );
+      }
+      throw error;
+    }
+  }
+};
+
+// src/client/modules/billing/index.ts
+function createBillingModule(config) {
+  const { verbose = false, skipTelemetry = false } = config;
+  const privateKey = addHexPrefix(config.privateKey);
+  const logger = getLogger(verbose);
+  const billingEnvConfig = getBillingEnvironmentConfig(getBuildType());
+  const billingApi = new BillingApiClient(billingEnvConfig, privateKey);
+  return {
+    async subscribe(opts) {
+      return withSDKTelemetry(
+        {
+          functionName: "subscribe",
+          skipTelemetry,
+          // Skip if called from CLI
+          properties: { productId: opts?.productId || "compute" }
+        },
+        async () => {
+          const productId = opts?.productId || "compute";
+          logger.debug(`Checking existing subscription for ${productId}...`);
+          const currentStatus = await billingApi.getSubscription(productId);
+          if (isSubscriptionActive(currentStatus.subscriptionStatus)) {
+            logger.debug(`Subscription already active: ${currentStatus.subscriptionStatus}`);
+            return {
+              type: "already_active",
+              status: currentStatus.subscriptionStatus
+            };
+          }
+          if (currentStatus.subscriptionStatus === "past_due" || currentStatus.subscriptionStatus === "unpaid") {
+            logger.debug(`Subscription has payment issue: ${currentStatus.subscriptionStatus}`);
+            return {
+              type: "payment_issue",
+              status: currentStatus.subscriptionStatus,
+              portalUrl: currentStatus.portalUrl
+            };
+          }
+          logger.debug(`Creating subscription for ${productId}...`);
+          const result = await billingApi.createSubscription(productId);
+          logger.debug(`Checkout URL: ${result.checkoutUrl}`);
+          return {
+            type: "checkout_created",
+            checkoutUrl: result.checkoutUrl
+          };
+        }
+      );
+    },
+    async getStatus(opts) {
+      return withSDKTelemetry(
+        {
+          functionName: "getStatus",
+          skipTelemetry,
+          // Skip if called from CLI
+          properties: { productId: opts?.productId || "compute" }
+        },
+        async () => {
+          const productId = opts?.productId || "compute";
+          logger.debug(`Fetching subscription status for ${productId}...`);
+          const result = await billingApi.getSubscription(productId);
+          logger.debug(`Subscription status: ${result.subscriptionStatus}`);
+          return result;
+        }
+      );
+    },
+    async cancel(opts) {
+      return withSDKTelemetry(
+        {
+          functionName: "cancel",
+          skipTelemetry,
+          // Skip if called from CLI
+          properties: { productId: opts?.productId || "compute" }
+        },
+        async () => {
+          const productId = opts?.productId || "compute";
+          logger.debug(`Checking subscription status for ${productId}...`);
+          const currentStatus = await billingApi.getSubscription(productId);
+          if (!isSubscriptionActive(currentStatus.subscriptionStatus)) {
+            logger.debug(`No active subscription to cancel: ${currentStatus.subscriptionStatus}`);
+            return {
+              type: "no_active_subscription",
+              status: currentStatus.subscriptionStatus
+            };
+          }
+          logger.debug(`Canceling subscription for ${productId}...`);
+          await billingApi.cancelSubscription(productId);
+          logger.debug(`Subscription canceled successfully`);
+          return {
+            type: "canceled"
+          };
+        }
+      );
+    }
+  };
+}
+
+export {
+  createBillingModule
+};
+//# sourceMappingURL=chunk-LINGJMAS.js.map

package/dist/chunk-LINGJMAS.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/client/common/utils/billingapi.ts","../src/client/modules/billing/index.ts"],"sourcesContent":["/**\n * BillingAPI Client to manage product subscriptions\n * Standalone client - does not depend on chain infrastructure\n */\n\nimport axios, { AxiosResponse } from \"axios\";\nimport { Hex } from \"viem\";\nimport { privateKeyToAccount } from \"viem/accounts\";\nimport { ProductID, CreateSubscriptionResponse, ProductSubscriptionResponse } from \"../types\";\nimport { calculateBillingAuthSignature } from \"./auth\";\nimport { BillingEnvironmentConfig } from \"../types\";\n\nexport class BillingApiClient {\n  private readonly account: ReturnType<typeof privateKeyToAccount>;\n  private readonly config: BillingEnvironmentConfig;\n\n  constructor(config: BillingEnvironmentConfig, privateKey: Hex) {\n    this.account = privateKeyToAccount(privateKey);\n    this.config = config;\n  }\n\n  async createSubscription(productId: ProductID = \"compute\"): Promise<CreateSubscriptionResponse> {\n    const endpoint = `${this.config.billingApiServerURL}/products/${productId}/subscription`;\n    const resp = await this.makeAuthenticatedRequest(endpoint, \"POST\", productId);\n    return resp.json();\n  }\n\n  async getSubscription(productId: ProductID = \"compute\"): Promise<ProductSubscriptionResponse> {\n    const endpoint = `${this.config.billingApiServerURL}/products/${productId}/subscription`;\n    const resp = await this.makeAuthenticatedRequest(endpoint, \"GET\", productId);\n    return resp.json();\n  }\n\n  async cancelSubscription(productId: ProductID = \"compute\"): Promise<void> {\n    const endpoint = `${this.config.billingApiServerURL}/products/${productId}/subscription`;\n    await this.makeAuthenticatedRequest(endpoint, \"DELETE\", productId);\n  }\n\n  /**\n   * Make an authenticated request to the billing API\n   */\n  private async makeAuthenticatedRequest(\n    url: string,\n    method: \"GET\" | \"POST\" | \"DELETE\",\n    productId: ProductID,\n  ): Promise<{ json: () => Promise<any>; text: () => Promise<string> }> {\n    // Calculate expiry (5 minutes from now)\n    const expiry = BigInt(Math.floor(Date.now() / 1000) + 5 * 60);\n\n    // Use EIP-712 typed data signature for billing auth\n    const { signature } = await calculateBillingAuthSignature({\n      account: this.account,\n      product: productId,\n      expiry,\n    });\n\n    // Prepare headers\n    const headers: Record<string, string> = {\n      Authorization: `Bearer ${signature}`,\n      \"X-Account\": this.account.address,\n      \"X-Expiry\": expiry.toString(),\n    };\n\n    try {\n      // Use axios to make the request\n      const response: AxiosResponse = await axios({\n        method,\n        url,\n        headers,\n        timeout: 30_000,\n        maxRedirects: 0,\n        validateStatus: () => true, // Don't throw on any status\n      });\n\n      const status = response.status;\n      const statusText = status >= 200 && status < 300 ? \"OK\" : \"Error\";\n\n      if (status < 200 || status >= 300) {\n        const body =\n          typeof response.data === \"string\" ? response.data : JSON.stringify(response.data);\n        throw new Error(`BillingAPI request failed: ${status} ${statusText} - ${body}`);\n      }\n\n      // Return Response-like object for compatibility\n      return {\n        json: async () => response.data,\n        text: async () =>\n          typeof response.data === \"string\" ? response.data : JSON.stringify(response.data),\n      };\n    } catch (error: any) {\n      // Handle network errors\n      if (\n        error.message?.includes(\"fetch failed\") ||\n        error.message?.includes(\"ECONNREFUSED\") ||\n        error.message?.includes(\"ENOTFOUND\") ||\n        error.cause\n      ) {\n        const cause = error.cause?.message || error.cause || error.message;\n        throw new Error(\n          `Failed to connect to BillingAPI at ${url}: ${cause}\\n` +\n            `Please check:\\n` +\n            `1. Your internet connection\\n` +\n            `2. The API server is accessible: ${this.config.billingApiServerURL}\\n` +\n            `3. Firewall/proxy settings`,\n        );\n      }\n      // Re-throw other errors as-is\n      throw error;\n    }\n  }\n}\n","/**\n * Main Billing namespace entry point\n */\n\nimport { BillingApiClient } from \"../../common/utils/billingapi\";\nimport { getBillingEnvironmentConfig, getBuildType } from \"../../common/config/environment\";\nimport { getLogger, isSubscriptionActive, addHexPrefix } from \"../../common/utils\";\nimport { withSDKTelemetry } from \"../../common/telemetry/wrapper\";\n\nimport type { Hex } from \"viem\";\nimport type {\n  ProductID,\n  SubscriptionOpts,\n  SubscribeResponse,\n  CancelResponse,\n  ProductSubscriptionResponse,\n} from \"../../common/types\";\n\nexport interface BillingModule {\n  subscribe: (opts?: SubscriptionOpts) => Promise<SubscribeResponse>;\n  getStatus: (opts?: SubscriptionOpts) => Promise<ProductSubscriptionResponse>;\n  cancel: (opts?: SubscriptionOpts) => Promise<CancelResponse>;\n}\n\nexport interface BillingModuleConfig {\n  verbose?: boolean;\n  privateKey: Hex;\n  skipTelemetry?: boolean; // Skip telemetry when called from CLI\n}\n\nexport function createBillingModule(config: BillingModuleConfig): BillingModule {\n  const { verbose = false, skipTelemetry = false } = config;\n  const privateKey = addHexPrefix(config.privateKey);\n\n  const logger = getLogger(verbose);\n\n  // Get billing environment configuration\n  const billingEnvConfig = getBillingEnvironmentConfig(getBuildType());\n\n  // Create billing API client\n  const billingApi = new BillingApiClient(billingEnvConfig, privateKey);\n\n  return {\n    async subscribe(opts) {\n      return withSDKTelemetry(\n        {\n          functionName: \"subscribe\",\n          skipTelemetry: skipTelemetry, // Skip if called from CLI\n          properties: { productId: opts?.productId || \"compute\" },\n        },\n        async () => {\n          const productId: ProductID = opts?.productId || \"compute\";\n\n          // Check existing subscription status first\n          logger.debug(`Checking existing subscription for ${productId}...`);\n          const currentStatus = await billingApi.getSubscription(productId);\n\n          // If already active or trialing, don't create new checkout\n          if (isSubscriptionActive(currentStatus.subscriptionStatus)) {\n            logger.debug(`Subscription already active: ${currentStatus.subscriptionStatus}`);\n            return {\n              type: \"already_active\" as const,\n              status: currentStatus.subscriptionStatus,\n            };\n          }\n\n          // If subscription has payment issues, return portal URL instead\n          if (\n            currentStatus.subscriptionStatus === \"past_due\" ||\n            currentStatus.subscriptionStatus === \"unpaid\"\n          ) {\n            logger.debug(`Subscription has payment issue: ${currentStatus.subscriptionStatus}`);\n            return {\n              type: \"payment_issue\" as const,\n              status: currentStatus.subscriptionStatus,\n              portalUrl: currentStatus.portalUrl,\n            };\n          }\n\n          // Create new checkout session\n          logger.debug(`Creating subscription for ${productId}...`);\n          const result = await billingApi.createSubscription(productId);\n\n          logger.debug(`Checkout URL: ${result.checkoutUrl}`);\n          return {\n            type: \"checkout_created\" as const,\n            checkoutUrl: result.checkoutUrl,\n          };\n        },\n      );\n    },\n\n    async getStatus(opts) {\n      return withSDKTelemetry(\n        {\n          functionName: \"getStatus\",\n          skipTelemetry: skipTelemetry, // Skip if called from CLI\n          properties: { productId: opts?.productId || \"compute\" },\n        },\n        async () => {\n          const productId: ProductID = opts?.productId || \"compute\";\n          logger.debug(`Fetching subscription status for ${productId}...`);\n\n          const result = await billingApi.getSubscription(productId);\n\n          logger.debug(`Subscription status: ${result.subscriptionStatus}`);\n          return result;\n        },\n      );\n    },\n\n    async cancel(opts) {\n      return withSDKTelemetry(\n        {\n          functionName: \"cancel\",\n          skipTelemetry: skipTelemetry, // Skip if called from CLI\n          properties: { productId: opts?.productId || \"compute\" },\n        },\n        async () => {\n          const productId: ProductID = opts?.productId || \"compute\";\n\n          // Check existing subscription status first\n          logger.debug(`Checking subscription status for ${productId}...`);\n          const currentStatus = await billingApi.getSubscription(productId);\n\n          // If no active subscription, don't attempt to cancel\n          if (!isSubscriptionActive(currentStatus.subscriptionStatus)) {\n            logger.debug(`No active subscription to cancel: ${currentStatus.subscriptionStatus}`);\n            return {\n              type: \"no_active_subscription\" as const,\n              status: currentStatus.subscriptionStatus,\n            };\n          }\n\n          // Cancel the subscription\n          logger.debug(`Canceling subscription for ${productId}...`);\n          await billingApi.cancelSubscription(productId);\n\n          logger.debug(`Subscription canceled successfully`);\n          return {\n            type: \"canceled\" as const,\n          };\n        },\n      );\n    },\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/compute.cjs

@@ -114,7 +114,7 @@ function getEnvironmentConfig(environment, chainID) {
   };
 }
 function getBuildType() {
-  const buildTimeType = true ? "prod"?.toLowerCase() : void 0;
+  const buildTimeType = true ? "dev"?.toLowerCase() : void 0;
   const runtimeType = process.env.BUILD_TYPE?.toLowerCase();
   const buildType = buildTimeType || runtimeType;
   if (buildType === "dev") {
@@ -2385,12 +2385,23 @@ function stripHexPrefix(value) {
 }
 
 // src/client/common/utils/userapi.ts
+function isJsonObject(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function readString(obj, key) {
+  const v = obj[key];
+  return typeof v === "string" ? v : void 0;
+}
+function readNumber(obj, key) {
+  const v = obj[key];
+  return typeof v === "number" && Number.isFinite(v) ? v : void 0;
+}
 var MAX_ADDRESS_COUNT = 5;
 var CanViewAppLogsPermission = "0x2fd3f2fe";
 var CanViewSensitiveAppInfoPermission = "0x0e67b22f";
 var CanUpdateAppProfilePermission = "0x036fef61";
 function getDefaultClientId() {
-  const version = true ? "0.1.1" : "0.0.0";
+  const version = true ? "0.2.0-dev" : "0.0.0";
   return `ecloud-sdk/v${version}`;
 }
 var UserApiClient = class {
@@ -2424,6 +2435,31 @@ var UserApiClient = class {
       };
     });
   }
+  /**
+   * Get app details from UserAPI (includes releases and build/provenance info when available).
+   *
+   * Endpoint: GET /apps/:appAddress
+   */
+  async getApp(appAddress) {
+    const endpoint = `${this.config.userApiServerURL}/apps/${appAddress}`;
+    const res = await this.makeAuthenticatedRequest(endpoint);
+    const raw = await res.json();
+    if (!isJsonObject(raw)) {
+      throw new Error("Unexpected /apps/:id response: expected object");
+    }
+    const id = readString(raw, "id");
+    if (!id) {
+      throw new Error("Unexpected /apps/:id response: missing 'id'");
+    }
+    const releasesRaw = raw.releases;
+    const releases = Array.isArray(releasesRaw) ? releasesRaw.map((r) => transformAppRelease(r)).filter((r) => !!r) : [];
+    return {
+      id,
+      creator: readString(raw, "creator"),
+      contractStatus: readString(raw, "contract_status") ?? readString(raw, "contractStatus"),
+      releases
+    };
+  }
   /**
    * Get available SKUs (instance types) from UserAPI
    */
@@ -2596,6 +2632,48 @@ Please check:
     };
   }
 };
+function transformAppReleaseBuild(raw) {
+  if (!isJsonObject(raw)) return void 0;
+  const depsRaw = raw.dependencies;
+  const deps = isJsonObject(depsRaw) ? Object.fromEntries(
+    Object.entries(depsRaw).flatMap(([digest, depRaw]) => {
+      const parsed = transformAppReleaseBuild(depRaw);
+      return parsed ? [[digest, parsed]] : [];
+    })
+  ) : void 0;
+  return {
+    buildId: readString(raw, "build_id") ?? readString(raw, "buildId"),
+    billingAddress: readString(raw, "billing_address") ?? readString(raw, "billingAddress"),
+    repoUrl: readString(raw, "repo_url") ?? readString(raw, "repoUrl"),
+    gitRef: readString(raw, "git_ref") ?? readString(raw, "gitRef"),
+    status: readString(raw, "status"),
+    buildType: readString(raw, "build_type") ?? readString(raw, "buildType"),
+    imageName: readString(raw, "image_name") ?? readString(raw, "imageName"),
+    imageDigest: readString(raw, "image_digest") ?? readString(raw, "imageDigest"),
+    imageUrl: readString(raw, "image_url") ?? readString(raw, "imageUrl"),
+    provenanceJson: raw.provenance_json ?? raw.provenanceJson,
+    provenanceSignature: readString(raw, "provenance_signature") ?? readString(raw, "provenanceSignature"),
+    createdAt: readString(raw, "created_at") ?? readString(raw, "createdAt"),
+    updatedAt: readString(raw, "updated_at") ?? readString(raw, "updatedAt"),
+    errorMessage: readString(raw, "error_message") ?? readString(raw, "errorMessage"),
+    dependencies: deps
+  };
+}
+function transformAppRelease(raw) {
+  if (!isJsonObject(raw)) return void 0;
+  return {
+    appId: readString(raw, "appId") ?? readString(raw, "app_id"),
+    rmsReleaseId: readString(raw, "rmsReleaseId") ?? readString(raw, "rms_release_id"),
+    imageDigest: readString(raw, "imageDigest") ?? readString(raw, "image_digest"),
+    registryUrl: readString(raw, "registryUrl") ?? readString(raw, "registry_url"),
+    publicEnv: readString(raw, "publicEnv") ?? readString(raw, "public_env"),
+    encryptedEnv: readString(raw, "encryptedEnv") ?? readString(raw, "encrypted_env"),
+    upgradeByTime: readNumber(raw, "upgradeByTime") ?? readNumber(raw, "upgrade_by_time"),
+    createdAt: readString(raw, "createdAt") ?? readString(raw, "created_at"),
+    createdAtBlock: readString(raw, "createdAtBlock") ?? readString(raw, "created_at_block"),
+    build: raw.build ? transformAppReleaseBuild(raw.build) : void 0
+  };
+}
 
 // src/client/common/abis/AppController.json
 var AppController_default = [