@hsuite/smart-engines-sdk 3.0.1 → 3.0.3

package/dist/index.js

@@ -1,22 +1,12 @@
 'use strict';
 
 var zod = require('zod');
-var common = require('@nestjs/common');
 
 var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __export = (target, all) => {
   for (var name in all)
     __defProp(target, name, { get: all[name], enumerable: true });
 };
-var __decorateClass = (decorators, target, key, kind) => {
-  var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc(target, key) : target;
-  for (var i = decorators.length - 1, decorator; i >= 0; i--)
-    if (decorator = decorators[i])
-      result = (decorator(result)) || result;
-  return result;
-};
-var __decorateParam = (index, decorator) => (target, key) => decorator(target, key, index);
 
 // src/_vendor/circuit-breaker.ts
 var DEFAULT_CIRCUIT_BREAKER_CONFIG = {
@@ -1735,14 +1725,14 @@ function createHttpClient(config) {
       throw new SdkHttpError(`Network error: ${err.message}`, 0, error);
     }
   }
-  async function upload(path, file, filename, metadata) {
+  async function upload(path, file, filename, metadata, fieldName = "file") {
     const url = `${config.baseUrl}${path}`;
     const controller = new AbortController();
     const timeoutId = setTimeout(() => controller.abort(), timeout * 2);
     try {
       const formData = new FormData();
       const blob = file instanceof Blob ? file : new Blob([new Uint8Array(file)]);
-      formData.append("file", blob, filename);
+      formData.append(fieldName, blob, filename);
       if (metadata) {
         for (const [key, value] of Object.entries(metadata)) {
           formData.append(key, value);
@@ -1786,7 +1776,7 @@ function createHttpClient(config) {
     get: (path) => request("GET", path),
     put: (path, body) => request("PUT", path, body),
     delete: (path) => request("DELETE", path),
-    upload,
+    upload: ((path, file, filename, metadata, fieldName) => upload(path, file, filename, metadata, fieldName)),
     setAuthToken
   };
   return client;
@@ -3629,49 +3619,101 @@ var DeploymentClient = class {
   }
   http;
   /**
-   * Create (deploy) a new app
+   * Step 1 — allocate appId + receive ephemeral push credentials for
+   * the cluster's per-tenant Harbor project.
+   *
+   * Each app gets its own Harbor project (`hsuite-customers-<appId>`)
+   * isolated by Harbor's RBAC. The push robot returned in
+   * `registry.{username, password}` is scoped to that project only —
+   * it cannot read or write any other tenant's images.
+   *
+   * **Single-use secret discipline:** `registry.password` is returned
+   * exactly once and is NOT persisted server-side. Store it locally
+   * for the `docker push` and discard. To rotate, call `init` again
+   * (issues a new robot under the same project).
+   *
+   * Use the credentials to `docker login` + `docker push`, then call
+   * {@link deploy} with the pushed image tag.
    */
-  async create(request) {
-    return this.http.post("/api/deployment/apps", request);
+  async init(request) {
+    return this.http.post("/api/deployment/apps/init", request);
   }
   /**
-   * List all deployed apps
+   * Step 3 (optional) — upload the SPA tarball.
+   *
+   * The tarball is content-addressed (SHA-256) and mounted read-only
+   * into the customer's pod alongside the backend container. Returns
+   * the hash + size so the caller can verify the upload.
+   */
+  async uploadFrontend(appId, bundle, filename = "bundle.tar.gz") {
+    return this.http.upload(
+      `/api/deployment/apps/${encodeURIComponent(appId)}/frontend`,
+      bundle,
+      filename,
+      void 0,
+      "bundle"
+    );
+  }
+  /**
+   * Step 4 — reconcile the runtime to k8s.
+   *
+   * Returns immediately with `status: 'deploying'`. Poll {@link status}
+   * until `runtime.runtimeState === 'RUNNING'` for the URL to be live.
+   */
+  async deploy(appId, request) {
+    return this.http.post(`/api/deployment/apps/${encodeURIComponent(appId)}/deploy`, request);
+  }
+  /**
+   * Roll back to a previously-deployed image tag (must exist in
+   * `runtime.deploymentHistory[]`).
+   */
+  async rollback(appId, request) {
+    return this.http.post(`/api/deployment/apps/${encodeURIComponent(appId)}/rollback`, request);
+  }
+  /**
+   * Live combined lifecycle + runtime status of an app.
+   */
+  async status(appId) {
+    return this.http.get(`/api/deployment/apps/${encodeURIComponent(appId)}/status`);
+  }
+  /**
+   * List all deployed apps for the authenticated developer.
    */
   async list() {
     return this.http.get("/api/deployment/apps");
   }
   /**
-   * Get app details
+   * Get app details.
    */
   async get(appId) {
     return this.http.get(`/api/deployment/apps/${encodeURIComponent(appId)}`);
   }
   /**
-   * Update app configuration
+   * Update app configuration. Runtime effect lands in PR-H.
    */
   async update(appId, updates) {
     return this.http.put(`/api/deployment/apps/${encodeURIComponent(appId)}`, updates);
   }
   /**
-   * Delete an app
+   * Delete an app. Runtime effect (namespace teardown) lands in PR-H.
    */
   async delete(appId) {
     return this.http.delete(`/api/deployment/apps/${encodeURIComponent(appId)}`);
   }
   /**
-   * Suspend an app
+   * Suspend an app. Runtime effect (scale to zero) lands in PR-H.
    */
   async suspend(appId) {
     return this.http.post(`/api/deployment/apps/${encodeURIComponent(appId)}/suspend`, {});
   }
   /**
-   * Resume a suspended app
+   * Resume a suspended app. Runtime effect (scale back up) lands in PR-H.
    */
   async resume(appId) {
     return this.http.post(`/api/deployment/apps/${encodeURIComponent(appId)}/resume`, {});
   }
   /**
-   * Get deployment statistics
+   * Get deployment statistics.
    */
   async getStats() {
     return this.http.get("/api/deployment/stats");
@@ -3801,6 +3843,78 @@ var AgentsClient = class {
   }
 };
 
+// src/baas/customer-session/index.ts
+var CustomerSessionClient = class {
+  constructor(baseUrl, timeoutMs = 3e4) {
+    this.baseUrl = baseUrl;
+    this.timeoutMs = timeoutMs;
+  }
+  baseUrl;
+  timeoutMs;
+  /**
+   * Step 1: ask the host to issue a fresh challenge for the customer to sign.
+   */
+  async challenge(input) {
+    return this.fetch("POST", "/api/customer-session/challenge", input);
+  }
+  /**
+   * Step 2: submit the customer's signed challenge. On success returns a
+   * short-lived bearer JWT scoped to {appId, chain, address}.
+   */
+  async verify(req) {
+    return this.fetch("POST", "/api/customer-session/verify", req);
+  }
+  /**
+   * Validate a customer bearer + return the decoded session info. Used by
+   * smart-app backends to authorise incoming customer requests.
+   */
+  async validate(bearer) {
+    return this.fetch("GET", "/api/customer-session/validate", void 0, bearer);
+  }
+  /**
+   * Revoke a customer session. Idempotent.
+   */
+  async end(bearer) {
+    return this.fetch(
+      "POST",
+      "/api/customer-session/end",
+      void 0,
+      bearer
+    );
+  }
+  async fetch(method, path, body, bearer) {
+    const url = `${this.baseUrl}${path}`;
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), this.timeoutMs);
+    try {
+      const headers = { "Content-Type": "application/json" };
+      if (bearer) headers["Authorization"] = `Bearer ${bearer}`;
+      const init = { method, headers, signal: controller.signal };
+      if (body !== void 0) init.body = JSON.stringify(body);
+      const response = await fetch(url, init);
+      clearTimeout(timeoutId);
+      if (!response.ok) {
+        const errBody = await response.json().catch(() => ({}));
+        const err = new Error(
+          errBody.message ?? `customer-session ${path} failed: ${response.status} ${response.statusText}`
+        );
+        err.status = response.status;
+        throw err;
+      }
+      const text = await response.text();
+      if (!text) return void 0;
+      return JSON.parse(text);
+    } catch (error) {
+      clearTimeout(timeoutId);
+      const e = error;
+      if (e.name === "AbortError") {
+        throw new Error(`customer-session ${path} timeout`);
+      }
+      throw error;
+    }
+  }
+};
+
 // src/baas/client.ts
 var BaasClient = class {
   hostUrl;
@@ -3825,6 +3939,8 @@ var BaasClient = class {
   deployment;
   /** Autonomous smart agent management */
   agents;
+  /** Customer→smart-app session bridge (TokenGate Face B). */
+  customerSession;
   constructor(config) {
     this.allowInsecure = config.allowInsecure ?? false;
     this.hostUrl = validateUrl2(config.hostUrl, this.allowInsecure);
@@ -3844,6 +3960,7 @@ var BaasClient = class {
     this.messaging = new MessagingClient(this.http, getAppId);
     this.deployment = new DeploymentClient(this.http);
     this.agents = new AgentsClient(this.http);
+    this.customerSession = new CustomerSessionClient(baseUrlWithPrefix, this.timeout);
   }
   /** Set the app ID (for newly registered apps) */
   setAppId(appId) {
@@ -3870,7 +3987,7 @@ var BaasClient = class {
   requireAppId() {
     if (!this.appId) {
       throw new BaasError(
-        "App ID required. Either provide appId in config or call register() first.",
+        "App ID required. Provide appId in config (e.g. from a prior deployment.init() call).",
         400
       );
     }
@@ -3917,12 +4034,6 @@ var BaasClient = class {
     }
     this.authToken = null;
   }
-  // ========== App Registration ==========
-  /** Register a new app on the BaaS host */
-  async register(request) {
-    this.requireAuth();
-    return this.post("/api/deployment/apps", request);
-  }
   // ========== HTTP Helpers ==========
   requireAuth() {
     if (!this.authToken) {
@@ -4010,293 +4121,6 @@ function validateUrl2(url, allowInsecure = false) {
   }
 }
 
-// src/nestjs/index.ts
-var nestjs_exports = {};
-__export(nestjs_exports, {
-  SMART_ENGINE_CONFIG: () => SMART_ENGINE_CONFIG,
-  SmartEngineModule: () => exports.SmartEngineModule,
-  SmartEngineService: () => exports.SmartEngineService
-});
-var SMART_ENGINE_CONFIG = "SMART_ENGINE_CONFIG";
-exports.SmartEngineService = class SmartEngineService {
-  constructor(config) {
-    this.config = config;
-  }
-  config;
-  logger = new common.Logger(exports.SmartEngineService.name);
-  client = null;
-  baasClient = null;
-  connected = false;
-  reconnectTimer = null;
-  reconnectAttempts = 0;
-  /**
-   * Initialize the service when the module starts
-   */
-  async onModuleInit() {
-    if (!this.config) {
-      this.logger.warn(
-        "SmartEngineService initialized without configuration. Call configure() before using."
-      );
-      return;
-    }
-    await this.initialize(this.config);
-  }
-  /**
-   * Clean up resources when the module is destroyed
-   */
-  async onModuleDestroy() {
-    await this.shutdown();
-  }
-  /**
-   * Initialize the service with configuration
-   *
-   * Can be called manually if not using DI configuration
-   */
-  async initialize(config) {
-    this.logger.log(`Initializing SmartEngineService for ${config.baseUrl}`);
-    try {
-      this.client = new SmartEngineClient({
-        baseUrl: config.baseUrl,
-        apiKey: config.apiKey,
-        authToken: config.authToken,
-        timeout: config.timeout,
-        allowInsecure: config.allowInsecure
-      });
-      this.baasClient = this.createBaasClient(this.client);
-      if (config.testConnection !== false) {
-        await this.testConnection();
-      }
-      this.connected = true;
-      this.reconnectAttempts = 0;
-      this.logger.log("SmartEngineService initialized successfully");
-    } catch (error) {
-      const err = error;
-      this.logger.error(`Failed to initialize SmartEngineService: ${err.message}`);
-      if (config.autoReconnect) {
-        this.scheduleReconnect(config);
-      } else {
-        throw error;
-      }
-    }
-  }
-  /**
-   * Gracefully shutdown the service
-   */
-  async shutdown() {
-    this.logger.log("Shutting down SmartEngineService");
-    if (this.reconnectTimer) {
-      clearTimeout(this.reconnectTimer);
-      this.reconnectTimer = null;
-    }
-    this.client = null;
-    this.baasClient = null;
-    this.connected = false;
-    this.logger.log("SmartEngineService shutdown complete");
-  }
-  /**
-   * Get the SmartEngineClient instance
-   *
-   * @throws SmartEngineError if client is not initialized
-   */
-  getClient() {
-    if (!this.client) {
-      throw new SmartEngineError2(
-        "SmartEngineClient not initialized. Ensure SmartEngineService is configured properly.",
-        500
-      );
-    }
-    return this.client;
-  }
-  /**
-   * Get the BaaS client for simplified blockchain access
-   *
-   * The BaaS client provides a simplified interface for applications
-   * that need managed blockchain infrastructure access.
-   *
-   * @throws SmartEngineError if client is not initialized
-   */
-  getBaasClient() {
-    if (!this.baasClient) {
-      throw new SmartEngineError2(
-        "BaasClient not initialized. Ensure SmartEngineService is configured properly.",
-        500
-      );
-    }
-    return this.baasClient;
-  }
-  /**
-   * Check if the service is connected and healthy
-   */
-  isConnected() {
-    return this.connected;
-  }
-  /**
-   * Test the connection to the validator
-   */
-  async testConnection() {
-    if (!this.client) {
-      return false;
-    }
-    try {
-      const health = await this.client.getHealth();
-      this.connected = health.status === "healthy" || health.status === "ok";
-      return this.connected;
-    } catch (error) {
-      const err = error;
-      this.logger.warn(`Connection test failed: ${err.message}`);
-      this.connected = false;
-      return false;
-    }
-  }
-  /**
-   * Get the current connection status
-   */
-  getStatus() {
-    return {
-      connected: this.connected,
-      baseUrl: this.client?.getBaseUrl() ?? null,
-      authenticated: this.client?.isAuthenticated() ?? false,
-      reconnectAttempts: this.reconnectAttempts
-    };
-  }
-  /**
-   * Create a SmartGatewayClient for gateway operations
-   */
-  createGatewayClient(config) {
-    return new SmartGatewayClient(config);
-  }
-  /**
-   * Create a BaaS client for host operations
-   */
-  createHostClient(config) {
-    return new BaasClient(config);
-  }
-  /**
-   * Create a BaaS client wrapper around the SmartEngineClient
-   */
-  createBaasClient(client) {
-    return {
-      client,
-      isHealthy: async () => {
-        try {
-          const health = await client.getHealth();
-          return health.status === "healthy" || health.status === "ok";
-        } catch {
-          return false;
-        }
-      },
-      getBaseUrl: () => client.getBaseUrl()
-    };
-  }
-  /**
-   * Schedule a reconnection attempt
-   */
-  scheduleReconnect(config) {
-    const maxAttempts = config.maxReconnectAttempts ?? 0;
-    const interval = config.reconnectInterval ?? 5e3;
-    if (maxAttempts > 0 && this.reconnectAttempts >= maxAttempts) {
-      this.logger.error(`Max reconnection attempts (${maxAttempts}) reached. Giving up.`);
-      return;
-    }
-    this.reconnectAttempts++;
-    this.logger.log(`Scheduling reconnection attempt ${this.reconnectAttempts} in ${interval}ms`);
-    this.reconnectTimer = setTimeout(async () => {
-      try {
-        await this.initialize(config);
-      } catch {
-      }
-    }, interval);
-  }
-};
-exports.SmartEngineService = __decorateClass([
-  common.Injectable(),
-  __decorateParam(0, common.Optional()),
-  __decorateParam(0, common.Inject(SMART_ENGINE_CONFIG))
-], exports.SmartEngineService);
-
-// src/nestjs/smart-engine.module.ts
-exports.SmartEngineModule = class SmartEngineModule {
-  /**
-   * Configure the module with static configuration
-   *
-   * @param config - SmartEngine service configuration
-   * @param isGlobal - Whether to make the module global (default: true)
-   */
-  static forRoot(config, isGlobal = true) {
-    return {
-      module: exports.SmartEngineModule,
-      global: isGlobal,
-      providers: [
-        {
-          provide: SMART_ENGINE_CONFIG,
-          useValue: config
-        },
-        exports.SmartEngineService
-      ],
-      exports: [exports.SmartEngineService]
-    };
-  }
-  /**
-   * Configure the module with async configuration
-   *
-   * Supports factory functions, configuration classes, and existing providers.
-   *
-   * @param options - Async configuration options
-   */
-  static forRootAsync(options) {
-    const asyncProviders = this.createAsyncProviders(options);
-    return {
-      module: exports.SmartEngineModule,
-      global: options.isGlobal ?? true,
-      imports: options.imports || [],
-      providers: [...asyncProviders, exports.SmartEngineService],
-      exports: [exports.SmartEngineService]
-    };
-  }
-  /**
-   * Create async providers based on configuration options
-   */
-  static createAsyncProviders(options) {
-    if (options.useFactory) {
-      return [
-        {
-          provide: SMART_ENGINE_CONFIG,
-          useFactory: options.useFactory,
-          inject: options.inject || []
-        }
-      ];
-    }
-    if (options.useClass) {
-      return [
-        {
-          provide: options.useClass,
-          useClass: options.useClass
-        },
-        {
-          provide: SMART_ENGINE_CONFIG,
-          useFactory: async (optionsFactory) => optionsFactory.createSmartEngineOptions(),
-          inject: [options.useClass]
-        }
-      ];
-    }
-    if (options.useExisting) {
-      return [
-        {
-          provide: SMART_ENGINE_CONFIG,
-          useFactory: async (optionsFactory) => optionsFactory.createSmartEngineOptions(),
-          inject: [options.useExisting]
-        }
-      ];
-    }
-    throw new Error(
-      "Invalid SmartEngineModuleAsyncOptions: must provide useFactory, useClass, or useExisting"
-    );
-  }
-};
-exports.SmartEngineModule = __decorateClass([
-  common.Module({})
-], exports.SmartEngineModule);
-
 exports.AgentsClient = AgentsClient;
 exports.BaasClient = BaasClient;
 exports.BaasError = BaasError;
@@ -4304,6 +4128,7 @@ exports.CapabilityNotEnabledError = CapabilityNotEnabledError;
 exports.CapabilityValidationError = CapabilityValidationError;
 exports.CircuitBreaker = CircuitBreaker;
 exports.CircuitBreakerOpenError = CircuitBreakerOpenError;
+exports.CustomerSessionClient = CustomerSessionClient;
 exports.DEFAULT_CIRCUIT_BREAKER_CONFIG = DEFAULT_CIRCUIT_BREAKER_CONFIG;
 exports.DEFAULT_RETRY_CONFIG = DEFAULT_RETRY_CONFIG;
 exports.DatabaseClient = DatabaseClient;
@@ -4319,7 +4144,6 @@ exports.MirrorNodeClient = MirrorNodeClient;
 exports.MirrorNodeError = MirrorNodeError;
 exports.RateLimiter = RateLimiter;
 exports.RoutingClient = RoutingClient;
-exports.SMART_ENGINE_CONFIG = SMART_ENGINE_CONFIG;
 exports.SdkHttpError = SdkHttpError;
 exports.SettlementClient = SettlementClient;
 exports.SmartEngineClient = SmartEngineClient;
@@ -4341,7 +4165,6 @@ exports.createHttpClient = createHttpClient;
 exports.createResilientFetchWithBreaker = createResilientFetchWithBreaker;
 exports.discovery = discovery_exports;
 exports.encodePathParam = encodePathParam;
-exports.nestjs = nestjs_exports;
 exports.resilientFetch = resilientFetch;
 exports.settlement = settlement_exports;
 exports.subscription = subscription_exports;