@hsuite/smart-engines-sdk 3.10.0 → 3.11.0

package/dist/nestjs/index.js

@@ -1152,7 +1152,7 @@ var SdkHttpError = class extends Error {
 };
 function createHttpClient(config) {
   const timeout = config.timeout ?? 3e4;
-  function getHeaders(contentType) {
+  function getHeaders(contentType, opts) {
     const headers = {};
     if (contentType) {
       headers["Content-Type"] = contentType;
@@ -1163,6 +1163,12 @@ function createHttpClient(config) {
     if (config.apiKey) {
       headers["X-API-Key"] = config.apiKey;
     }
+    if (opts?.customerToken) {
+      headers["X-Customer-Session-Token"] = opts.customerToken;
+    }
+    if (opts?.headers) {
+      Object.assign(headers, opts.headers);
+    }
     return headers;
   }
   function setAuthToken(token) {
@@ -1171,14 +1177,14 @@ function createHttpClient(config) {
   function getAuthToken() {
     return config.authToken;
   }
-  async function request(method, path, body) {
+  async function request(method, path, body, opts) {
     const url = `${config.baseUrl}${path}`;
     const controller = new AbortController();
     const timeoutId = setTimeout(() => controller.abort(), timeout);
     try {
       const init = {
         method,
-        headers: getHeaders("application/json"),
+        headers: getHeaders("application/json", opts),
         signal: controller.signal
       };
       if (body !== void 0) {
@@ -1207,14 +1213,14 @@ function createHttpClient(config) {
       throw new SdkHttpError(`Network error: ${err.message}`, 0, error);
     }
   }
-  async function getText(path) {
+  async function getText(path, opts) {
     const url = `${config.baseUrl}${path}`;
     const controller = new AbortController();
     const timeoutId = setTimeout(() => controller.abort(), timeout);
     try {
       const response = await fetch(url, {
         method: "GET",
-        headers: getHeaders(),
+        headers: getHeaders(void 0, opts),
         signal: controller.signal
       });
       clearTimeout(timeoutId);
@@ -1237,7 +1243,37 @@ function createHttpClient(config) {
       throw new SdkHttpError(`Network error: ${err.message}`, 0, error);
     }
   }
-  async function upload(path, file, filename, metadata, fieldName = "file") {
+  async function getBinary(path, opts) {
+    const url = `${config.baseUrl}${path}`;
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), timeout);
+    try {
+      const response = await fetch(url, {
+        method: "GET",
+        headers: getHeaders(void 0, opts),
+        signal: controller.signal
+      });
+      clearTimeout(timeoutId);
+      if (!response.ok) {
+        const errBody = await response.json().catch(() => ({}));
+        throw new SdkHttpError(
+          errBody.message || `API error: ${response.status} ${response.statusText}`,
+          response.status,
+          errBody
+        );
+      }
+      return new Uint8Array(await response.arrayBuffer());
+    } catch (error) {
+      clearTimeout(timeoutId);
+      if (error instanceof SdkHttpError) throw error;
+      const err = error;
+      if (err.name === "AbortError") {
+        throw new SdkHttpError("Request timeout", 408);
+      }
+      throw new SdkHttpError(`Network error: ${err.message}`, 0, error);
+    }
+  }
+  async function upload(path, file, filename, metadata, fieldName = "file", opts) {
     const url = `${config.baseUrl}${path}`;
     const controller = new AbortController();
     const timeoutId = setTimeout(() => controller.abort(), timeout * 2);
@@ -1257,6 +1293,12 @@ function createHttpClient(config) {
       if (config.apiKey) {
         headers["X-API-Key"] = config.apiKey;
       }
+      if (opts?.customerToken) {
+        headers["X-Customer-Session-Token"] = opts.customerToken;
+      }
+      if (opts?.headers) {
+        Object.assign(headers, opts.headers);
+      }
       const response = await fetch(url, {
         method: "POST",
         headers,
@@ -1304,13 +1346,14 @@ function createHttpClient(config) {
     }
   }
   const client = {
-    post: (path, body) => withAuthRetry(path, () => request("POST", path, body)),
-    get: (path) => withAuthRetry(path, () => request("GET", path)),
-    put: (path, body) => withAuthRetry(path, () => request("PUT", path, body)),
-    patch: (path, body) => withAuthRetry(path, () => request("PATCH", path, body)),
-    delete: (path) => withAuthRetry(path, () => request("DELETE", path)),
-    getText: (path) => withAuthRetry(path, () => getText(path)),
-    upload: ((path, file, filename, metadata, fieldName) => withAuthRetry(path, () => upload(path, file, filename, metadata, fieldName))),
+    post: (path, body, opts) => withAuthRetry(path, () => request("POST", path, body, opts)),
+    get: (path, opts) => withAuthRetry(path, () => request("GET", path, void 0, opts)),
+    put: (path, body, opts) => withAuthRetry(path, () => request("PUT", path, body, opts)),
+    patch: (path, body, opts) => withAuthRetry(path, () => request("PATCH", path, body, opts)),
+    delete: (path, opts) => withAuthRetry(path, () => request("DELETE", path, void 0, opts)),
+    getText: (path, opts) => withAuthRetry(path, () => getText(path, opts)),
+    getBinary: (path, opts) => withAuthRetry(path, () => getBinary(path, opts)),
+    upload: ((path, file, filename, metadata, fieldName, opts) => withAuthRetry(path, () => upload(path, file, filename, metadata, fieldName, opts))),
     setAuthToken,
     getAuthToken
   };
@@ -2937,50 +2980,58 @@ var AgentsClient = class {
   }
   http;
   /** Register a new agent */
-  async register(request) {
-    return this.http.post("/api/v3/baas/agents/register", request);
+  async register(request, opts) {
+    return this.http.post("/api/v3/baas/agents/register", request, opts);
   }
   /** Get agent details */
-  async get(agentId) {
-    return this.http.get(`/api/v3/baas/agents/${encodePathParam(agentId)}`);
+  async get(agentId, opts) {
+    return this.http.get(`/api/v3/baas/agents/${encodePathParam(agentId)}`, opts);
   }
   /** List all agents */
-  async list() {
-    return this.http.get("/api/v3/baas/agents");
+  async list(opts) {
+    return this.http.get("/api/v3/baas/agents", opts);
   }
   /**
    * Fund agent treasury (owner-only). Returns a
    * `PreparedTransactionResponse` wrapped in a `success: true` envelope —
    * the caller is expected to sign and submit the prepared bytes.
    */
-  async fund(agentId, request) {
-    return this.http.post(`/api/v3/baas/agents/${encodePathParam(agentId)}/fund`, request);
+  async fund(agentId, request, opts) {
+    return this.http.post(`/api/v3/baas/agents/${encodePathParam(agentId)}/fund`, request, opts);
   }
   /**
    * Execute a trade (agent-wallet OR owner). Returns a
    * `PreparedTransactionResponse` wrapped in a `success: true` envelope.
    */
-  async trade(agentId, request) {
-    return this.http.post(`/api/v3/baas/agents/${encodePathParam(agentId)}/trade`, request);
+  async trade(agentId, request, opts) {
+    return this.http.post(`/api/v3/baas/agents/${encodePathParam(agentId)}/trade`, request, opts);
   }
   /**
    * Withdraw from agent treasury (owner-only). Returns a
    * `PreparedTransactionResponse` wrapped in a `success: true` envelope.
    */
-  async withdraw(agentId, request) {
-    return this.http.post(`/api/v3/baas/agents/${encodePathParam(agentId)}/withdraw`, request);
+  async withdraw(agentId, request, opts) {
+    return this.http.post(`/api/v3/baas/agents/${encodePathParam(agentId)}/withdraw`, request, opts);
+  }
+  /**
+   * Execute a generic, declared capability (agent-wallet OR owner). The
+   * chain-agnostic general form of an agent action: the capability may settle
+   * on-chain, act off-chain, or both. Returns the ordered step results.
+   */
+  async execute(agentId, request, opts) {
+    return this.http.post(`/api/v3/baas/agents/${encodePathParam(agentId)}/execute`, request, opts);
   }
   /** Pause an agent */
-  async pause(agentId) {
-    return this.http.post(`/api/v3/baas/agents/${encodePathParam(agentId)}/pause`, {});
+  async pause(agentId, opts) {
+    return this.http.post(`/api/v3/baas/agents/${encodePathParam(agentId)}/pause`, {}, opts);
   }
   /** Resume a paused agent */
-  async resume(agentId) {
-    return this.http.post(`/api/v3/baas/agents/${encodePathParam(agentId)}/resume`, {});
+  async resume(agentId, opts) {
+    return this.http.post(`/api/v3/baas/agents/${encodePathParam(agentId)}/resume`, {}, opts);
   }
   /** Revoke an agent (permanent) */
-  async revoke(agentId) {
-    return this.http.post(`/api/v3/baas/agents/${encodePathParam(agentId)}/revoke`, {});
+  async revoke(agentId, opts) {
+    return this.http.post(`/api/v3/baas/agents/${encodePathParam(agentId)}/revoke`, {}, opts);
   }
   /**
    * Update agent rules.
@@ -2990,24 +3041,24 @@ var AgentsClient = class {
    * Nest matched the dynamic `:agentId` GET/POST handlers and rejected
    * the verb mismatch.
    */
-  async updateRules(agentId, rules) {
-    return this.http.patch(`/api/v3/baas/agents/${encodePathParam(agentId)}/rules`, rules);
+  async updateRules(agentId, rules, opts) {
+    return this.http.patch(`/api/v3/baas/agents/${encodePathParam(agentId)}/rules`, rules, opts);
   }
   /** Get agent events */
-  async getEvents(agentId) {
-    return this.http.get(`/api/v3/baas/agents/${encodePathParam(agentId)}/events`);
+  async getEvents(agentId, opts) {
+    return this.http.get(`/api/v3/baas/agents/${encodePathParam(agentId)}/events`, opts);
   }
   /** Get agent balances across chains */
-  async getBalances(agentId) {
-    return this.http.get(`/api/v3/baas/agents/${encodePathParam(agentId)}/balances`);
+  async getBalances(agentId, opts) {
+    return this.http.get(`/api/v3/baas/agents/${encodePathParam(agentId)}/balances`, opts);
   }
   /** Approve a pending agent operation */
-  async approve(agentId, operationId) {
-    return this.http.post(`/api/v3/baas/agents/${encodePathParam(agentId)}/approve/${encodePathParam(operationId)}`, {});
+  async approve(agentId, operationId, opts) {
+    return this.http.post(`/api/v3/baas/agents/${encodePathParam(agentId)}/approve/${encodePathParam(operationId)}`, {}, opts);
   }
   /** Reject a pending agent operation */
-  async reject(agentId, operationId) {
-    return this.http.post(`/api/v3/baas/agents/${encodePathParam(agentId)}/reject/${encodePathParam(operationId)}`, {});
+  async reject(agentId, operationId, opts) {
+    return this.http.post(`/api/v3/baas/agents/${encodePathParam(agentId)}/reject/${encodePathParam(operationId)}`, {}, opts);
   }
 };
 
@@ -4343,30 +4394,31 @@ var StorageClient = class {
   /**
    * Upload a file to storage
    */
-  async upload(file, filename, metadata) {
+  async upload(file, filename, metadata, opts) {
     const appId = this.getAppId();
-    return this.http.upload(`/api/v3/baas/storage/${encodePathParam(appId)}/upload`, file, filename, metadata);
+    return this.http.upload(`/api/v3/baas/storage/${encodePathParam(appId)}/upload`, file, filename, metadata, void 0, opts);
   }
   /**
-   * Download a file by CID
+   * Download a file by CID. Returns the raw file bytes as a `Uint8Array`
+   * (binary-safe — never JSON-parsed or text-decoded).
    */
-  async download(cid) {
+  async download(cid, opts) {
     const appId = this.getAppId();
-    return this.http.get(`/api/v3/baas/storage/${encodePathParam(appId)}/download/${encodePathParam(cid)}`);
+    return this.http.getBinary(`/api/v3/baas/storage/${encodePathParam(appId)}/download/${encodePathParam(cid)}`, opts);
   }
   /**
    * Get file metadata
    */
-  async getMetadata(cid) {
+  async getMetadata(cid, opts) {
     const appId = this.getAppId();
-    return this.http.get(`/api/v3/baas/storage/${encodePathParam(appId)}/metadata/${encodePathParam(cid)}`);
+    return this.http.get(`/api/v3/baas/storage/${encodePathParam(appId)}/metadata/${encodePathParam(cid)}`, opts);
   }
   /**
    * Delete a file
    */
-  async delete(cid) {
+  async delete(cid, opts) {
     const appId = this.getAppId();
-    return this.http.delete(`/api/v3/baas/storage/${encodePathParam(appId)}/${encodePathParam(cid)}`);
+    return this.http.delete(`/api/v3/baas/storage/${encodePathParam(appId)}/${encodePathParam(cid)}`, opts);
   }
   /**
    * List all files for the app.
@@ -4375,27 +4427,27 @@ var StorageClient = class {
    *   `offset` for pagination).
    * @returns The file list and total count.
    */
-  async listFiles(pagination) {
+  async listFiles(pagination, opts) {
     const appId = this.getAppId();
     const params = new URLSearchParams();
     if (pagination?.limit !== void 0) params.set("limit", String(pagination.limit));
     if (pagination?.offset !== void 0) params.set("offset", String(pagination.offset));
     const qs = params.toString();
-    return this.http.get(`/api/v3/baas/storage/${encodePathParam(appId)}/files${qs ? `?${qs}` : ""}`);
+    return this.http.get(`/api/v3/baas/storage/${encodePathParam(appId)}/files${qs ? `?${qs}` : ""}`, opts);
   }
   /**
    * Get storage usage for the current app
    */
-  async getUsage() {
+  async getUsage(opts) {
     const appId = this.getAppId();
-    return this.http.get(`/api/v3/baas/storage/${encodePathParam(appId)}/usage`);
+    return this.http.get(`/api/v3/baas/storage/${encodePathParam(appId)}/usage`, opts);
   }
   /**
    * Check if a file exists
    */
-  async exists(cid) {
+  async exists(cid, opts) {
     const appId = this.getAppId();
-    return this.http.get(`/api/v3/baas/storage/${encodePathParam(appId)}/exists/${encodePathParam(cid)}`);
+    return this.http.get(`/api/v3/baas/storage/${encodePathParam(appId)}/exists/${encodePathParam(cid)}`, opts);
   }
 };
 
@@ -4408,61 +4460,99 @@ var FunctionsClient = class {
   http;
   getAppId;
   /**
-   * Deploy a new function
-   */
-  async deploy(request) {
+   * Build the Ed25519 signed-code envelope the host mandates for every deploy
+   * and eval. A fresh ephemeral keypair is generated per call, so no long-lived
+   * signing key is held anywhere — each artifact carries its own signature.
+   *
+   * Scheme (must match the host verifier): `hash = sha256(code)` (hex),
+   * `message = "<hash>:<timestamp>"`, signed Ed25519; `publicKey` is SPKI-DER
+   * (base64). `crypto` is imported lazily so this never pulls Node built-ins
+   * into a browser bundle that doesn't sign code.
+   */
+  async signCode(code) {
+    const { generateKeyPairSync, createHash, sign } = await import('crypto');
+    const { publicKey, privateKey } = generateKeyPairSync("ed25519");
+    const hash = createHash("sha256").update(code, "utf8").digest("hex");
+    const timestamp = (/* @__PURE__ */ new Date()).toISOString();
+    const signature = sign(null, Buffer.from(`${hash}:${timestamp}`, "utf8"), privateKey).toString("base64");
+    const publicKeyDer = publicKey.export({ format: "der", type: "spki" }).toString("base64");
+    return { code, hash, timestamp, signature, publicKey: publicKeyDer };
+  }
+  /**
+   * Deploy a new function. If `signedCode` is omitted it is auto-built from
+   * `request.code` via {@link signCode} — the host requires it, so the default
+   * is to sign rather than 400. Pass your own envelope to override.
+   */
+  async deploy(request, opts) {
     const appId = this.getAppId();
-    return this.http.post(`/api/v3/baas/functions/${encodePathParam(appId)}`, request);
+    const signedCode = request.signedCode ?? await this.signCode(request.code);
+    return this.http.post(`/api/v3/baas/functions/${encodePathParam(appId)}`, { ...request, signedCode }, opts);
   }
   /**
    * Invoke a function
    */
-  async invoke(functionId, payload) {
+  async invoke(functionId, payload, opts) {
     const appId = this.getAppId();
     return this.http.post(
       `/api/v3/baas/functions/${encodePathParam(appId)}/${encodePathParam(functionId)}/invoke`,
-      payload ?? {}
+      payload ?? {},
+      opts
     );
   }
+  /**
+   * Evaluate signed code once (ephemeral) — no persistent deploy.
+   *
+   * For throwaway / AI-generated snippets. The host runs it in the same hardened
+   * isolate and discards it; metered + quota'd like a normal invocation. As with
+   * {@link deploy}, `signedCode` is auto-built from `request.code` when omitted.
+   */
+  async eval(request, opts) {
+    const appId = this.getAppId();
+    const signedCode = request.signedCode ?? await this.signCode(request.code);
+    return this.http.post(`/api/v3/baas/functions/${encodePathParam(appId)}/eval`, { ...request, signedCode }, opts);
+  }
   /**
    * List all functions for the current app
    */
-  async list() {
+  async list(opts) {
     const appId = this.getAppId();
-    return this.http.get(`/api/v3/baas/functions/${encodePathParam(appId)}`);
+    return this.http.get(`/api/v3/baas/functions/${encodePathParam(appId)}`, opts);
   }
   /**
    * Get function details
    */
-  async get(functionId) {
+  async get(functionId, opts) {
     const appId = this.getAppId();
     return this.http.get(
-      `/api/v3/baas/functions/${encodePathParam(appId)}/${encodePathParam(functionId)}`
+      `/api/v3/baas/functions/${encodePathParam(appId)}/${encodePathParam(functionId)}`,
+      opts
     );
   }
   /**
    * Update a function
    */
-  async update(functionId, updates) {
+  async update(functionId, updates, opts) {
     const appId = this.getAppId();
     return this.http.put(
       `/api/v3/baas/functions/${encodePathParam(appId)}/${encodePathParam(functionId)}`,
-      updates
+      updates,
+      opts
     );
   }
   /**
    * Delete a function
    */
-  async delete(functionId) {
+  async delete(functionId, opts) {
     const appId = this.getAppId();
     return this.http.delete(
-      `/api/v3/baas/functions/${encodePathParam(appId)}/${encodePathParam(functionId)}`
+      `/api/v3/baas/functions/${encodePathParam(appId)}/${encodePathParam(functionId)}`,
+      opts
     );
   }
   /**
    * Get function execution logs
    */
-  async getLogs(functionId, options) {
+  async getLogs(functionId, options, opts) {
     const appId = this.getAppId();
     const params = new URLSearchParams();
     if (options?.limit !== void 0) params.set("limit", String(options.limit));
@@ -4470,15 +4560,16 @@ var FunctionsClient = class {
     if (options?.level) params.set("level", options.level);
     const qs = params.toString();
     return this.http.get(
-      `/api/v3/baas/functions/${encodePathParam(appId)}/${encodePathParam(functionId)}/logs${qs ? `?${qs}` : ""}`
+      `/api/v3/baas/functions/${encodePathParam(appId)}/${encodePathParam(functionId)}/logs${qs ? `?${qs}` : ""}`,
+      opts
     );
   }
   /**
    * Get function statistics for an app
    */
-  async getStats() {
+  async getStats(opts) {
     const appId = this.getAppId();
-    return this.http.get(`/api/v3/baas/functions/${encodePathParam(appId)}/stats`);
+    return this.http.get(`/api/v3/baas/functions/${encodePathParam(appId)}/stats`, opts);
   }
 };
 
@@ -4493,45 +4584,46 @@ var MessagingClient = class {
   /**
    * Create a new channel
    */
-  async createChannel(config) {
+  async createChannel(config, opts) {
     const appId = this.getAppId();
-    return this.http.post(`/api/v3/baas/messaging/${encodePathParam(appId)}/channels`, config);
+    return this.http.post(`/api/v3/baas/messaging/${encodePathParam(appId)}/channels`, config, opts);
   }
   /**
    * Delete a channel
    */
-  async deleteChannel(channelId) {
+  async deleteChannel(channelId, opts) {
     const appId = this.getAppId();
-    return this.http.delete(`/api/v3/baas/messaging/${encodePathParam(appId)}/channels/${encodePathParam(channelId)}`);
+    return this.http.delete(`/api/v3/baas/messaging/${encodePathParam(appId)}/channels/${encodePathParam(channelId)}`, opts);
   }
   /**
    * Get a channel by ID
    */
-  async getChannel(channelId) {
+  async getChannel(channelId, opts) {
     const appId = this.getAppId();
-    return this.http.get(`/api/v3/baas/messaging/${encodePathParam(appId)}/channels/${encodePathParam(channelId)}`);
+    return this.http.get(`/api/v3/baas/messaging/${encodePathParam(appId)}/channels/${encodePathParam(channelId)}`, opts);
   }
   /**
    * List all channels for the app
    */
-  async listChannels() {
+  async listChannels(opts) {
     const appId = this.getAppId();
-    return this.http.get(`/api/v3/baas/messaging/${encodePathParam(appId)}/channels`);
+    return this.http.get(`/api/v3/baas/messaging/${encodePathParam(appId)}/channels`, opts);
   }
   /**
    * Publish a message to a channel
    */
-  async publish(channel, message, metadata) {
+  async publish(channel, message, metadata, opts) {
     const appId = this.getAppId();
     return this.http.post(
       `/api/v3/baas/messaging/${encodePathParam(appId)}/channels/${encodePathParam(channel)}/publish`,
-      { data: message, metadata }
+      { data: message, metadata },
+      opts
     );
   }
   /**
    * Get message history for a channel
    */
-  async getHistory(channel, options) {
+  async getHistory(channel, options, opts) {
     const appId = this.getAppId();
     const params = new URLSearchParams();
     if (options?.limit !== void 0) params.set("limit", String(options.limit));
@@ -4539,7 +4631,8 @@ var MessagingClient = class {
     if (options?.after) params.set("after", options.after);
     const qs = params.toString();
     return this.http.get(
-      `/api/v3/baas/messaging/${encodePathParam(appId)}/channels/${encodePathParam(channel)}/history${qs ? `?${qs}` : ""}`
+      `/api/v3/baas/messaging/${encodePathParam(appId)}/channels/${encodePathParam(channel)}/history${qs ? `?${qs}` : ""}`,
+      opts
     );
   }
   /**
@@ -4550,11 +4643,12 @@ var MessagingClient = class {
    * `setPresence(member)` hit a non-existent appId-scoped route and 404'd
    * in production. The channel is now the first argument.
    */
-  async setPresence(channel, member) {
+  async setPresence(channel, member, opts) {
     const appId = this.getAppId();
     return this.http.post(
       `/api/v3/baas/messaging/${encodePathParam(appId)}/channels/${encodePathParam(channel)}/presence`,
-      member
+      member,
+      opts
     );
   }
   /**
@@ -4566,27 +4660,29 @@ var MessagingClient = class {
    * `clientId` (not `memberId`) the second — they're the same identifier
    * but renamed to match the server param.
    */
-  async removePresence(channel, clientId) {
+  async removePresence(channel, clientId, opts) {
     const appId = this.getAppId();
     return this.http.delete(
-      `/api/v3/baas/messaging/${encodePathParam(appId)}/channels/${encodePathParam(channel)}/presence/${encodePathParam(clientId)}`
+      `/api/v3/baas/messaging/${encodePathParam(appId)}/channels/${encodePathParam(channel)}/presence/${encodePathParam(clientId)}`,
+      opts
     );
   }
   /**
    * Get presence info for a channel
    */
-  async getPresence(channel) {
+  async getPresence(channel, opts) {
     const appId = this.getAppId();
     return this.http.get(
-      `/api/v3/baas/messaging/${encodePathParam(appId)}/channels/${encodePathParam(channel)}/presence`
+      `/api/v3/baas/messaging/${encodePathParam(appId)}/channels/${encodePathParam(channel)}/presence`,
+      opts
     );
   }
   /**
    * Get messaging statistics
    */
-  async getStats() {
+  async getStats(opts) {
     const appId = this.getAppId();
-    return this.http.get(`/api/v3/baas/messaging/${encodePathParam(appId)}/stats`);
+    return this.http.get(`/api/v3/baas/messaging/${encodePathParam(appId)}/stats`, opts);
   }
 };