@hashgraphonline/standards-sdk 0.1.158 → 0.1.159

package/dist/es/standards-sdk.es148.js

@@ -4391,6 +4391,14 @@ function detectKeyTypeFromString(privateKeyString) {
     }
   }
 }
+function normalizeAuthBaseUrl(input) {
+  let url2 = input.trim();
+  url2 = url2.replace(/\/+$/, "");
+  if (url2.endsWith("/api")) {
+    return url2.slice(0, -4);
+  }
+  return url2;
+}
 class Auth {
   constructor(config) {
     __publicField(this, "accountId");
@@ -4405,7 +4413,9 @@ class Auth {
       this.privateKey = config.privateKey;
     }
     this.network = config.network || "mainnet";
-    this.baseUrl = config.baseUrl || "https://kiloscribe.com";
+    this.baseUrl = normalizeAuthBaseUrl(
+      config.baseUrl || "https://kiloscribe.com"
+    );
   }
   async authenticate() {
     var _a2, _b2, _c;
@@ -11305,6 +11315,125 @@ Object.assign(lookup, {
   io: lookup,
   connect: lookup
 });
+function isRecord(value2) {
+  return typeof value2 === "object" && value2 !== null;
+}
+function collectMessageStrings(value2, out, depth = 0) {
+  if (depth > 5) return;
+  if (typeof value2 === "string") {
+    const trimmed = value2.trim();
+    if (trimmed) out.push(trimmed);
+    return;
+  }
+  if (Array.isArray(value2)) {
+    for (const item of value2) collectMessageStrings(item, out, depth + 1);
+    return;
+  }
+  if (!isRecord(value2)) return;
+  const directKeys = [
+    "message",
+    "error",
+    "detail",
+    "reason",
+    "title",
+    "description"
+  ];
+  for (const key of directKeys) {
+    collectMessageStrings(value2[key], out, depth + 1);
+  }
+  const nestedKeys = ["errors", "details", "causes", "cause"];
+  for (const key of nestedKeys) {
+    collectMessageStrings(value2[key], out, depth + 1);
+  }
+}
+function summarizeUnknown(value2) {
+  if (typeof value2 === "string") return value2.trim();
+  try {
+    return JSON.stringify(value2);
+  } catch {
+    return String(value2);
+  }
+}
+function getAxiosStatus(error) {
+  var _a2, _b2;
+  if (axios.isAxiosError(error)) {
+    return (_a2 = error.response) == null ? void 0 : _a2.status;
+  }
+  const maybe = error;
+  return (_b2 = maybe.response) == null ? void 0 : _b2.status;
+}
+function getAxiosCode(error) {
+  if (axios.isAxiosError(error)) {
+    return error.code;
+  }
+  const maybe = error;
+  return maybe.code;
+}
+function getAxiosResponseData(error) {
+  var _a2, _b2;
+  if (axios.isAxiosError(error)) {
+    return (_a2 = error.response) == null ? void 0 : _a2.data;
+  }
+  const maybe = error;
+  return (_b2 = maybe.response) == null ? void 0 : _b2.data;
+}
+function isRetryableStartInscriptionError(error) {
+  if (error instanceof Error && error.name === "ValidationError") {
+    return false;
+  }
+  const status = getAxiosStatus(error);
+  if (typeof status === "number") {
+    return [408, 425, 429, 500, 502, 503, 504].includes(status);
+  }
+  const code2 = getAxiosCode(error);
+  if (!code2) return false;
+  return [
+    "ECONNRESET",
+    "ETIMEDOUT",
+    "EAI_AGAIN",
+    "ENOTFOUND",
+    "ECONNREFUSED",
+    "ERR_NETWORK"
+  ].includes(code2);
+}
+function formatStartInscriptionError(error) {
+  const status = getAxiosStatus(error);
+  const code2 = getAxiosCode(error);
+  const responseData = getAxiosResponseData(error);
+  const messages = [];
+  collectMessageStrings(responseData, messages);
+  collectMessageStrings(error, messages);
+  const unique = Array.from(new Set(messages)).filter(Boolean);
+  const normalizedGenericMarkers = /* @__PURE__ */ new Set([
+    "failed to start inscription",
+    "failed to start inscribe job",
+    "request failed",
+    "bad request"
+  ]);
+  const informative = unique.filter((message) => {
+    const normalized = message.toLowerCase().trim();
+    if (!normalized) {
+      return false;
+    }
+    if (normalizedGenericMarkers.has(normalized)) {
+      return false;
+    }
+    if (normalized.startsWith("failed to start inscription")) {
+      return false;
+    }
+    return true;
+  });
+  const best = informative.sort((a, b) => b.length - a.length)[0] ?? unique[0] ?? (error instanceof Error ? error.message : "");
+  const suffixParts = [
+    typeof status === "number" ? `HTTP ${status}` : null,
+    code2 ? `code=${code2}` : null
+  ].filter(Boolean);
+  const suffix = suffixParts.length ? ` (${suffixParts.join(", ")})` : "";
+  if (best) {
+    return `Failed to start inscription${suffix}: ${best}`;
+  }
+  return `Failed to start inscription${suffix}: ${summarizeUnknown(responseData) || summarizeUnknown(error)}`;
+}
 const _InscriptionSDK = class _InscriptionSDK2 {
   constructor(config) {
     __publicField(this, "client");
@@ -11326,7 +11455,7 @@ const _InscriptionSDK = class _InscriptionSDK2 {
       "Content-Type": "application/json"
     };
     this.client = axios.create({
-      baseURL: "https://v2-api.tier.bot/api",
+      baseURL: config.baseURL || config.baseUrl || "https://v2-api.tier.bot/api",
       headers
     });
     this.logger = Logger.getInstance();
@@ -11479,68 +11608,72 @@ const _InscriptionSDK = class _InscriptionSDK2 {
    * @throws Error if the inscription fails
    */
   async startInscription(request) {
-    var _a2, _b2;
     try {
-      this.validateRequest(request);
-      let mimeType = request.file.mimeType;
-      if (request.file.type === "url") {
-        const fileMetadata = await this.getFileMetadata(request.file.url);
-        mimeType = fileMetadata.mimeType || mimeType;
-        if (fileMetadata.size > _InscriptionSDK2.MAX_URL_FILE_SIZE) {
-          throw new ValidationError(
-            `File size exceeds maximum URL file limit of ${_InscriptionSDK2.MAX_URL_FILE_SIZE / 1024 / 1024}MB`
-          );
+      const operation = async () => {
+        this.validateRequest(request);
+        let mimeType = request.file.mimeType;
+        if (request.file.type === "url") {
+          const fileMetadata = await this.getFileMetadata(request.file.url);
+          mimeType = fileMetadata.mimeType || mimeType;
+          if (fileMetadata.size > _InscriptionSDK2.MAX_URL_FILE_SIZE) {
+            throw new ValidationError(
+              `File size exceeds maximum URL file limit of ${_InscriptionSDK2.MAX_URL_FILE_SIZE / 1024 / 1024}MB`
+            );
+          }
+        } else if (request.file.type === "base64") {
+          mimeType = await this.detectMimeTypeFromBase64(request.file.base64);
         }
-      } else if (request.file.type === "base64") {
-        mimeType = await this.detectMimeTypeFromBase64(request.file.base64);
-      }
-      if (mimeType === "image/vnd.microsoft.icon") {
-        mimeType = this.normalizeMimeType(mimeType);
-      }
-      if (request.jsonFileURL) {
-        const jsonMetadata = await this.getFileMetadata(request.jsonFileURL);
-        if (jsonMetadata.mimeType !== "application/json") {
-          throw new ValidationError(
-            "JSON file must be of type application/json"
+        if (mimeType === "image/vnd.microsoft.icon") {
+          mimeType = this.normalizeMimeType(mimeType);
+        }
+        if (request.jsonFileURL) {
+          const jsonMetadata = await this.getFileMetadata(request.jsonFileURL);
+          if (jsonMetadata.mimeType !== "application/json") {
+            throw new ValidationError(
+              "JSON file must be of type application/json"
+            );
+          }
+        }
+        const requestBody = {
+          holderId: request.holderId,
+          mode: request.mode,
+          network: this.config.network,
+          onlyJSONCollection: request.onlyJSONCollection ? 1 : 0,
+          creator: request.creator,
+          description: request.description,
+          fileStandard: request.fileStandard,
+          metadataObject: request.metadataObject,
+          jsonFileURL: request.jsonFileURL
+        };
+        if (request.file.type === "url") {
+          const response2 = await this.client.post(
+            "/inscriptions/start-inscription",
+            {
+              ...requestBody,
+              fileURL: request.file.url
+            }
           );
+          return response2.data;
         }
-      }
-      const requestBody = {
-        holderId: request.holderId,
-        mode: request.mode,
-        network: this.config.network,
-        onlyJSONCollection: request.onlyJSONCollection ? 1 : 0,
-        creator: request.creator,
-        description: request.description,
-        fileStandard: request.fileStandard,
-        metadataObject: request.metadataObject,
-        jsonFileURL: request.jsonFileURL
-      };
-      let response;
-      if (request.file.type === "url") {
-        response = await this.client.post("/inscriptions/start-inscription", {
-          ...requestBody,
-          fileURL: request.file.url
-        });
-      } else {
-        response = await this.client.post("/inscriptions/start-inscription", {
+        const response = await this.client.post("/inscriptions/start-inscription", {
           ...requestBody,
           fileBase64: request.file.base64,
           fileName: request.file.fileName,
           fileMimeType: mimeType || this.getMimeType(request.file.fileName)
         });
-      }
-      return response.data;
+        return response.data;
+      };
+      return await this.retryWithBackoff(operation, {
+        shouldRetry: isRetryableStartInscriptionError
+      });
     } catch (error) {
       if (error instanceof ValidationError) {
         throw error;
       }
       if (axios.isAxiosError(error)) {
-        throw new Error(
-          ((_b2 = (_a2 = error.response) == null ? void 0 : _a2.data) == null ? void 0 : _b2.message) || "Failed to start inscription"
-        );
+        throw new Error(formatStartInscriptionError(error));
       }
-      throw error;
+      throw new Error(formatStartInscriptionError(error));
     }
   }
   /**
@@ -11642,11 +11775,10 @@ const _InscriptionSDK = class _InscriptionSDK2 {
           );
           return wsResult;
         } catch (error) {
-          this.logger.error(
-            "WebSocket inscription failed, falling back to HTTP:",
+          this.logger.warn(
+            "WebSocket inscription failed, falling back to HTTP",
             error
           );
-          throw error;
         }
       } else {
         this.logger.info(
@@ -11772,26 +11904,31 @@ const _InscriptionSDK = class _InscriptionSDK2 {
         (_b2 = this.socket) == null ? void 0 : _b2.off("inscription-complete", completeHandler);
         (_c = this.socket) == null ? void 0 : _c.off("inscription-error", errorHandler);
       };
-      const TIMEOUT_MS = 6e4;
-      timeoutHandle = setTimeout(() => {
-        this.logger.error(
-          `WebSocket inscription timeout after ${TIMEOUT_MS / 1e3} seconds`,
-          {
+      const timeoutMs = this.config.websocketInactivityTimeoutMs;
+      const scheduleTimeout = () => {
+        if (!timeoutMs || timeoutMs <= 0) return;
+        if (timeoutHandle) clearTimeout(timeoutHandle);
+        timeoutHandle = setTimeout(() => {
+          this.logger.error(
+            `WebSocket inscription timeout after ${timeoutMs / 1e3} seconds`,
+            {
+              jobId,
+              transactionId,
+              lastTopicId: topicId
+            }
+          );
+          cleanup();
+          resolve({
             jobId,
             transactionId,
-            lastTopicId: topicId
-          }
-        );
-        cleanup();
-        resolve({
-          jobId,
-          transactionId,
-          topicId,
-          topic_id: topicId,
-          status: "timeout",
-          completed: false
-        });
-      }, TIMEOUT_MS);
+            topicId,
+            topic_id: topicId,
+            status: "timeout",
+            completed: false
+          });
+        }, timeoutMs);
+      };
+      scheduleTimeout();
       const completeHandler = (data) => {
         cleanup();
         resolve({
@@ -11808,6 +11945,7 @@ const _InscriptionSDK = class _InscriptionSDK2 {
         reject(new Error(data.error || "Inscription failed"));
       };
       const progressHandler = (data) => {
+        scheduleTimeout();
         this.logger.debug("Progress event received:", {
           jobId: data.jobId,
           status: data.status,
@@ -11961,15 +12099,19 @@ const _InscriptionSDK = class _InscriptionSDK2 {
       transactionId
     };
   }
-  async retryWithBackoff(operation, maxRetries = 3, baseDelay = 1e3) {
+  async retryWithBackoff(operation, options) {
+    const maxRetries = (options == null ? void 0 : options.maxRetries) ?? 3;
+    const baseDelayMs = (options == null ? void 0 : options.baseDelayMs) ?? 1e3;
+    const shouldRetry = (options == null ? void 0 : options.shouldRetry) ?? (() => true);
     for (let attempt = 0; attempt < maxRetries; attempt++) {
       try {
         return await operation();
       } catch (error) {
-        if (attempt === maxRetries - 1) {
+        const isLastAttempt = attempt === maxRetries - 1;
+        if (isLastAttempt || !shouldRetry(error)) {
           throw error;
         }
-        const delay = baseDelay * Math.pow(2, attempt);
+        const delay = baseDelayMs * Math.pow(2, attempt);
         await new Promise((resolve) => setTimeout(resolve, delay));
         this.logger.debug(
           `Retry attempt ${attempt + 1}/${maxRetries} after ${delay}ms delay`
@@ -11999,7 +12141,11 @@ const _InscriptionSDK = class _InscriptionSDK2 {
         );
         const result = response.data;
         const isCompleted = result.completed || result.status.toLowerCase() === "completed";
-        return { ...result, completed: isCompleted, jobId: result.id };
+        return {
+          ...result,
+          completed: isCompleted,
+          jobId: result.tx_id || formattedTransactionId
+        };
       });
     } catch (error) {
       this.logger.error("Failed to retrieve inscription:", error);
@@ -12047,12 +12193,13 @@ const _InscriptionSDK = class _InscriptionSDK2 {
     return new _InscriptionSDK2({
       apiKey,
       network: config.network || "mainnet",
+      baseURL: config.baseUrl,
       wsBaseUrl: config.wsBaseUrl,
       connectionMode: config.connectionMode || "websocket"
     });
   }
-  async waitForInscription(txId, maxAttempts = 30, intervalMs = 4e3, checkCompletion = false, progressCallback) {
-    var _a2;
+  async waitForInscription(txId, maxAttempts = Number.MAX_SAFE_INTEGER, intervalMs = 4e3, checkCompletion = false, progressCallback) {
+    var _a2, _b2;
     let attempts = 0;
     let highestPercentSoFar = 0;
     const reportProgress = (stage, message, percent, details) => {
@@ -12121,6 +12268,7 @@ const _InscriptionSDK = class _InscriptionSDK2 {
       );
       const isHashinal = result.mode === "hashinal";
       const isHashinalCollection = result.mode === "hashinal-collection";
+      const isBulkFiles = result.mode === "bulk-files";
       const isDynamic = ((_a2 = result.fileStandard) == null ? void 0 : _a2.toString()) === "6";
       if (isHashinalCollection && isCompleted) {
         if (!checkCompletion || isCompleted) {
@@ -12166,6 +12314,19 @@ const _InscriptionSDK = class _InscriptionSDK2 {
           return result;
         }
       }
+      if (isBulkFiles && isCompleted) {
+        const bulkUploads = (_b2 = result.files) == null ? void 0 : _b2.bulkUploads;
+        const hasBulkUploads = Array.isArray(bulkUploads) && bulkUploads.length > 0;
+        if (!checkCompletion || hasBulkUploads) {
+          reportProgress(
+            "completed",
+            "Inscription verification complete",
+            100,
+            { result }
+          );
+          return result;
+        }
+      }
       await new Promise((resolve) => setTimeout(resolve, intervalMs));
       attempts++;
     }
@@ -12218,9 +12379,10 @@ __publicField(_InscriptionSDK, "VALID_MODES", [
   "file",
   "upload",
   "hashinal",
-  "hashinal-collection"
+  "hashinal-collection",
+  "bulk-files"
 ]);
-__publicField(_InscriptionSDK, "MAX_BASE64_SIZE", 2 * 1024 * 1024);
+__publicField(_InscriptionSDK, "MAX_BASE64_SIZE", 32 * 1024 * 1024);
 __publicField(_InscriptionSDK, "MAX_URL_FILE_SIZE", 100 * 1024 * 1024);
 __publicField(_InscriptionSDK, "VALID_MIME_TYPES", {
   jpg: "image/jpeg",