@hashgraphonline/standards-sdk 0.0.182 → 0.0.183

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

@@ -1,5 +1,207 @@
-const isBrowser = typeof window !== "undefined" && typeof window.document !== "undefined";
+import { I as InscriptionSDK } from "./standards-sdk.es73.js";
+class QuoteCache {
+  constructor() {
+    this.cache = /* @__PURE__ */ new Map();
+    this.maxSize = 100;
+    this.defaultTtlMs = 5 * 60 * 1e3;
+  }
+  // 5 minutes
+  /**
+   * Generate cache key from input parameters
+   */
+  generateKey(key) {
+    return `${key.inputHash}-${key.clientConfigHash}-${key.optionsHash}`;
+  }
+  /**
+   * Hash object to string for cache key
+   */
+  hashObject(obj) {
+    return Buffer.from(JSON.stringify(obj)).toString("base64").slice(0, 16);
+  }
+  /**
+   * Create cache key from parameters
+   */
+  createCacheKey(input, clientConfig, options) {
+    return {
+      inputHash: this.hashObject(input),
+      clientConfigHash: this.hashObject({
+        accountId: clientConfig.accountId,
+        network: clientConfig.network
+      }),
+      optionsHash: this.hashObject({
+        mode: options.mode,
+        apiKey: options.apiKey ? "present" : "absent",
+        network: options.network,
+        metadata: options.metadata
+      })
+    };
+  }
+  /**
+   * Get cached quote if available and not expired
+   */
+  get(key) {
+    const cacheKey = this.generateKey(key);
+    const entry = this.cache.get(cacheKey);
+    if (!entry) {
+      return null;
+    }
+    const now = Date.now();
+    if (now - entry.timestamp > entry.ttlMs) {
+      this.cache.delete(cacheKey);
+      return null;
+    }
+    this.cache.delete(cacheKey);
+    this.cache.set(cacheKey, entry);
+    return entry.quote;
+  }
+  /**
+   * Store quote in cache
+   */
+  set(key, quote, ttlMs = this.defaultTtlMs) {
+    const cacheKey = this.generateKey(key);
+    if (this.cache.size >= this.maxSize) {
+      const firstKey = this.cache.keys().next().value;
+      if (firstKey) {
+        this.cache.delete(firstKey);
+      }
+    }
+    this.cache.set(cacheKey, {
+      quote,
+      timestamp: Date.now(),
+      ttlMs
+    });
+  }
+  /**
+   * Clear all cached entries
+   */
+  clear() {
+    this.cache.clear();
+  }
+}
+class SDKCache {
+  constructor() {
+    this.cache = /* @__PURE__ */ new Map();
+    this.maxSize = 10;
+    this.defaultTtlMs = 30 * 60 * 1e3;
+  }
+  // 30 minutes
+  /**
+   * Generate config key for SDK instance
+   */
+  generateConfigKey(config) {
+    return Buffer.from(JSON.stringify(config)).toString("base64");
+  }
+  /**
+   * Get cached SDK instance
+   */
+  get(config) {
+    const configKey = this.generateConfigKey(config);
+    const entry = this.cache.get(configKey);
+    if (!entry) {
+      return null;
+    }
+    const now = Date.now();
+    if (now - entry.timestamp > this.defaultTtlMs) {
+      this.cache.delete(configKey);
+      return null;
+    }
+    return entry.sdk;
+  }
+  /**
+   * Store SDK instance in cache
+   */
+  set(config, sdk) {
+    const configKey = this.generateConfigKey(config);
+    if (this.cache.size >= this.maxSize) {
+      const firstKey = this.cache.keys().next().value;
+      if (firstKey) {
+        this.cache.delete(firstKey);
+      }
+    }
+    this.cache.set(configKey, {
+      sdk,
+      timestamp: Date.now(),
+      config: configKey
+    });
+  }
+  /**
+   * Clear all cached SDK instances
+   */
+  clear() {
+    this.cache.clear();
+  }
+}
+const quoteCache = new QuoteCache();
+const sdkCache = new SDKCache();
+async function getOrCreateSDK(clientConfig, options, existingSDK) {
+  if (existingSDK) {
+    return existingSDK;
+  }
+  const cacheConfig = {
+    apiKey: options.apiKey,
+    accountId: clientConfig.accountId,
+    network: clientConfig.network || "mainnet",
+    authType: options.apiKey ? "api" : "server"
+  };
+  const cachedSDK = sdkCache.get(cacheConfig);
+  if (cachedSDK) {
+    return cachedSDK;
+  }
+  let sdk;
+  if (options.apiKey) {
+    sdk = new InscriptionSDK({
+      apiKey: options.apiKey,
+      network: clientConfig.network || "mainnet"
+    });
+  } else {
+    sdk = await InscriptionSDK.createWithAuth({
+      type: "server",
+      accountId: clientConfig.accountId,
+      privateKey: clientConfig.privateKey,
+      network: clientConfig.network || "mainnet"
+    });
+  }
+  sdkCache.set(cacheConfig, sdk);
+  return sdk;
+}
+function getCachedQuote(input, clientConfig, options) {
+  const cacheKey = quoteCache.createCacheKey(input, clientConfig, options);
+  return quoteCache.get(cacheKey);
+}
+function cacheQuote(input, clientConfig, options, quote) {
+  const cacheKey = quoteCache.createCacheKey(input, clientConfig, options);
+  const quoteTtlMs = 10 * 60 * 1e3;
+  quoteCache.set(cacheKey, quote, quoteTtlMs);
+}
+function validateQuoteParameters(input, clientConfig, options) {
+  if (!input || typeof input !== "object" || !("type" in input)) {
+    throw new Error("Invalid inscription input: type is required");
+  }
+  if (!clientConfig || !clientConfig.accountId) {
+    throw new Error("Invalid client config: accountId is required");
+  }
+  if (!options) {
+    throw new Error("Options are required");
+  }
+  if (options.mode === "hashinal") {
+    if (!options.metadata) {
+      throw new Error("Hashinal mode requires metadata");
+    }
+    const requiredFields = ["name", "creator", "description", "type"];
+    const missingFields = requiredFields.filter(
+      (field) => !options.metadata || !options.metadata[field]
+    );
+    if (missingFields.length > 0) {
+      throw new Error(
+        `Missing required Hashinal metadata fields: ${missingFields.join(", ")}`
+      );
+    }
+  }
+}
 export {
-  isBrowser
+  cacheQuote,
+  getCachedQuote,
+  getOrCreateSDK,
+  validateQuoteParameters
 };
 //# sourceMappingURL=standards-sdk.es83.js.map

package/dist/es/standards-sdk.es83.js.map

@@ -1 +1 @@
-{"version":3,"file":"standards-sdk.es83.js","sources":["../../src/utils/is-browser.ts"],"sourcesContent":["/**\n * Determines if the current environment is a browser\n */\nexport const isBrowser =\n  typeof window !== 'undefined' && typeof window.document !== 'undefined';\n"],"names":[],"mappings":"AAGO,MAAM,YACX,OAAO,WAAW,eAAe,OAAO,OAAO,aAAa;"}
+{"version":3,"file":"standards-sdk.es83.js","sources":["../../src/inscribe/quote-cache.ts"],"sourcesContent":["/**\n * Performance optimization utilities for quote generation\n */\n\nimport { InscriptionSDK } from '@kiloscribe/inscription-sdk';\nimport { HederaClientConfig, InscriptionOptions, QuoteResult } from './types';\n\ninterface CacheKey {\n  inputHash: string;\n  clientConfigHash: string;\n  optionsHash: string;\n}\n\ninterface CacheEntry {\n  quote: QuoteResult;\n  timestamp: number;\n  ttlMs: number;\n}\n\ninterface SDKCacheEntry {\n  sdk: InscriptionSDK;\n  timestamp: number;\n  config: string;\n}\n\n/**\n * LRU Cache for quote results to improve performance\n */\nclass QuoteCache {\n  private cache = new Map<string, CacheEntry>();\n  private maxSize = 100;\n  private defaultTtlMs = 5 * 60 * 1000; // 5 minutes\n\n  /**\n   * Generate cache key from input parameters\n   */\n  private generateKey(key: CacheKey): string {\n    return `${key.inputHash}-${key.clientConfigHash}-${key.optionsHash}`;\n  }\n\n  /**\n   * Hash object to string for cache key\n   */\n  private hashObject(obj: unknown): string {\n    return Buffer.from(JSON.stringify(obj)).toString('base64').slice(0, 16);\n  }\n\n  /**\n   * Create cache key from parameters\n   */\n  createCacheKey(\n    input: unknown,\n    clientConfig: HederaClientConfig,\n    options: InscriptionOptions,\n  ): CacheKey {\n    return {\n      inputHash: this.hashObject(input),\n      clientConfigHash: this.hashObject({\n        accountId: clientConfig.accountId,\n        network: clientConfig.network,\n      }),\n      optionsHash: this.hashObject({\n        mode: options.mode,\n        apiKey: options.apiKey ? 'present' : 'absent',\n        network: options.network,\n        metadata: options.metadata,\n      }),\n    };\n  }\n\n  /**\n   * Get cached quote if available and not expired\n   */\n  get(key: CacheKey): QuoteResult | null {\n    const cacheKey = this.generateKey(key);\n    const entry = this.cache.get(cacheKey);\n\n    if (!entry) {\n      return null;\n    }\n\n    const now = Date.now();\n    if (now - entry.timestamp > entry.ttlMs) {\n      this.cache.delete(cacheKey);\n      return null;\n    }\n\n    this.cache.delete(cacheKey);\n    this.cache.set(cacheKey, entry);\n\n    return entry.quote;\n  }\n\n  /**\n   * Store quote in cache\n   */\n  set(\n    key: CacheKey,\n    quote: QuoteResult,\n    ttlMs: number = this.defaultTtlMs,\n  ): void {\n    const cacheKey = this.generateKey(key);\n\n    // Evict oldest entries if cache is full\n    if (this.cache.size >= this.maxSize) {\n      const firstKey = this.cache.keys().next().value;\n      if (firstKey) {\n        this.cache.delete(firstKey);\n      }\n    }\n\n    this.cache.set(cacheKey, {\n      quote,\n      timestamp: Date.now(),\n      ttlMs,\n    });\n  }\n\n  /**\n   * Clear all cached entries\n   */\n  clear(): void {\n    this.cache.clear();\n  }\n}\n\n/**\n * SDK instance cache for reuse\n */\nclass SDKCache {\n  private cache = new Map<string, SDKCacheEntry>();\n  private maxSize = 10;\n  private defaultTtlMs = 30 * 60 * 1000; // 30 minutes\n\n  /**\n   * Generate config key for SDK instance\n   */\n  private generateConfigKey(config: unknown): string {\n    return Buffer.from(JSON.stringify(config)).toString('base64');\n  }\n\n  /**\n   * Get cached SDK instance\n   */\n  get(config: Record<string, unknown>): InscriptionSDK | null {\n    const configKey = this.generateConfigKey(config);\n    const entry = this.cache.get(configKey);\n\n    if (!entry) {\n      return null;\n    }\n\n    const now = Date.now();\n    if (now - entry.timestamp > this.defaultTtlMs) {\n      this.cache.delete(configKey);\n      return null;\n    }\n\n    return entry.sdk;\n  }\n\n  /**\n   * Store SDK instance in cache\n   */\n  set(config: Record<string, unknown>, sdk: InscriptionSDK): void {\n    const configKey = this.generateConfigKey(config);\n\n    // Evict oldest entries if cache is full\n    if (this.cache.size >= this.maxSize) {\n      const firstKey = this.cache.keys().next().value;\n      if (firstKey) {\n        this.cache.delete(firstKey);\n      }\n    }\n\n    this.cache.set(configKey, {\n      sdk,\n      timestamp: Date.now(),\n      config: configKey,\n    });\n  }\n\n  /**\n   * Clear all cached SDK instances\n   */\n  clear(): void {\n    this.cache.clear();\n  }\n}\n\n// Global cache instances\nconst quoteCache = new QuoteCache();\nconst sdkCache = new SDKCache();\n\n/**\n * Get or create SDK instance with caching\n */\nexport async function getOrCreateSDK(\n  clientConfig: HederaClientConfig,\n  options: InscriptionOptions,\n  existingSDK?: InscriptionSDK,\n): Promise<InscriptionSDK> {\n  if (existingSDK) {\n    return existingSDK;\n  }\n\n  const cacheConfig = {\n    apiKey: options.apiKey,\n    accountId: clientConfig.accountId,\n    network: clientConfig.network || 'mainnet',\n    authType: options.apiKey ? 'api' : 'server',\n  };\n\n  const cachedSDK = sdkCache.get(cacheConfig);\n  if (cachedSDK) {\n    return cachedSDK;\n  }\n\n  let sdk: InscriptionSDK;\n\n  if (options.apiKey) {\n    sdk = new InscriptionSDK({\n      apiKey: options.apiKey,\n      network: clientConfig.network || 'mainnet',\n    });\n  } else {\n    sdk = await InscriptionSDK.createWithAuth({\n      type: 'server',\n      accountId: clientConfig.accountId,\n      privateKey: clientConfig.privateKey,\n      network: clientConfig.network || 'mainnet',\n    });\n  }\n\n  sdkCache.set(cacheConfig, sdk);\n  return sdk;\n}\n\n/**\n * Check if quote is cached and return it if valid\n */\nexport function getCachedQuote(\n  input: unknown,\n  clientConfig: HederaClientConfig,\n  options: InscriptionOptions,\n): QuoteResult | null {\n  const cacheKey = quoteCache.createCacheKey(input, clientConfig, options);\n  return quoteCache.get(cacheKey);\n}\n\n/**\n * Cache a generated quote\n */\nexport function cacheQuote(\n  input: unknown,\n  clientConfig: HederaClientConfig,\n  options: InscriptionOptions,\n  quote: QuoteResult,\n): void {\n  const cacheKey = quoteCache.createCacheKey(input, clientConfig, options);\n  const quoteTtlMs = 10 * 60 * 1000;\n  quoteCache.set(cacheKey, quote, quoteTtlMs);\n}\n\n/**\n * Pre-validate parameters for early error detection\n */\nexport function validateQuoteParameters(\n  input: unknown,\n  clientConfig: HederaClientConfig,\n  options: InscriptionOptions,\n): void {\n  if (!input || typeof input !== 'object' || !('type' in input)) {\n    throw new Error('Invalid inscription input: type is required');\n  }\n\n  if (!clientConfig || !clientConfig.accountId) {\n    throw new Error('Invalid client config: accountId is required');\n  }\n\n  if (!options) {\n    throw new Error('Options are required');\n  }\n\n  if (options.mode === 'hashinal') {\n    if (!options.metadata) {\n      throw new Error('Hashinal mode requires metadata');\n    }\n\n    const requiredFields = ['name', 'creator', 'description', 'type'];\n    const missingFields = requiredFields.filter(\n      field => !options.metadata || !options.metadata[field],\n    );\n\n    if (missingFields.length > 0) {\n      throw new Error(\n        `Missing required Hashinal metadata fields: ${missingFields.join(', ')}`,\n      );\n    }\n  }\n}\n\n/**\n * Clear all caches (useful for testing or memory management)\n */\nexport function clearAllCaches(): void {\n  quoteCache.clear();\n  sdkCache.clear();\n}\n"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hashgraphonline/standards-sdk",
-  "version": "0.0.182",
+  "version": "0.0.183",
   "description": "The Hashgraph Online Standards SDK provides a complete implementation of the Hashgraph Consensus Standards (HCS), giving developers all the tools needed to build applications on Hedera.",
   "type": "module",
   "files": [
@@ -33,6 +33,7 @@
     ".": {
       "types": "./dist/es/index.d.ts",
       "import": "./dist/es/standards-sdk.es.js",
+      "browser": "./dist/es/standards-sdk.es.js",
       "require": "./dist/cjs/standards-sdk.cjs",
       "default": "./dist/es/standards-sdk.es.js"
     }