@hashgraphonline/conversational-agent 0.2.216 → 0.2.218

package/dist/esm/index25.js

@@ -1,157 +1,190 @@
-import { EntityFormat } from "./index26.js";
-import { Logger, HederaMirrorNode } from "@hashgraphonline/standards-sdk";
-class FormatConverterRegistry {
-  constructor() {
-    this.converters = /* @__PURE__ */ new Map();
-    this.entityTypeCache = /* @__PURE__ */ new Map();
-    this.logger = new Logger({ module: "FormatConverterRegistry" });
-    this.defaultCacheTTL = 5 * 60 * 1e3;
+import { ContentStorage } from "./index22.js";
+import { Logger, ContentStoreService, ContentResolverRegistry, shouldUseReference, extractReferenceId } from "@hashgraphonline/standards-sdk";
+class ContentStorageAdapter {
+  constructor(storage) {
+    this.storage = storage;
   }
-  /**
-   * Register a format converter
-   */
-  register(converter) {
-    const key = `${converter.sourceFormat}→${converter.targetFormat}`;
-    this.converters.set(key, converter);
-  }
-  /**
-   * Find a converter for the given source and target formats
-   */
-  findConverter(source, target) {
-    const key = `${source}→${target}`;
-    return this.converters.get(key) || null;
+  async storeContent(content, metadata) {
+    const storeMetadata = {
+      contentType: "binary",
+      sizeBytes: content.length,
+      source: "system",
+      ...metadata
+    };
+    const contentRef = await this.storage.storeContent(content, storeMetadata);
+    return contentRef.referenceId;
   }
-  /**
-   * Convert an entity to the target format
-   */
-  async convertEntity(entity, target, context) {
-    const sourceFormat = await this.detectFormatWithFallback(entity, context);
-    if (sourceFormat === target) {
-      return entity;
-    }
-    const converter = this.findConverter(sourceFormat, target);
-    if (!converter) {
-      throw new Error(`No converter found for ${sourceFormat} → ${target}`);
-    }
-    if (!converter.canConvert(entity, context)) {
-      throw new Error(`Converter cannot handle entity: ${entity}`);
+  async resolveReference(referenceId) {
+    const result = await this.storage.resolveReference(referenceId);
+    if (result.success && result.content) {
+      const response = {
+        content: result.content
+      };
+      if (result.metadata) {
+        response.metadata = {
+          ...result.metadata.mimeType !== void 0 && {
+            mimeType: result.metadata.mimeType
+          },
+          ...result.metadata.fileName !== void 0 && {
+            fileName: result.metadata.fileName
+          },
+          originalSize: result.metadata.sizeBytes
+        };
+      }
+      return response;
+    } else {
+      throw new Error(result.error || "Reference not found");
     }
-    const result = await converter.convert(entity, context);
-    return result;
+  }
+  async hasReference(referenceId) {
+    return await this.storage.hasReference(referenceId);
+  }
+  async cleanupReference(referenceId) {
+    await this.storage.cleanupReference(referenceId);
+  }
+  async getStats() {
+    return await this.storage.getStats();
+  }
+  async updateConfig(config) {
+    const referenceConfig = {
+      sizeThresholdBytes: config.maxSize || 10240,
+      enableAutoCleanup: config.enableCompression || true,
+      ...config
+    };
+    return await this.storage.updateConfig(referenceConfig);
+  }
+  async performCleanup() {
+    await this.storage.performCleanup();
+  }
+  async dispose() {
+    return Promise.resolve(this.storage.dispose());
+  }
+}
+class ContentResolver {
+  constructor(adapter) {
+    this.adapter = adapter;
+  }
+  async resolveReference(referenceId) {
+    return await this.adapter.resolveReference(referenceId);
+  }
+  shouldUseReference(content) {
+    return shouldUseReference(content);
+  }
+  extractReferenceId(input) {
+    return extractReferenceId(input);
+  }
+}
+class ContentStoreManager {
+  constructor(maxMessageStorage = 1e3, referenceConfig, logger) {
+    this.isRegistered = false;
+    this.logger = logger || new Logger({ module: "ContentStoreManager" });
+    this.contentStorage = new ContentStorage(
+      maxMessageStorage,
+      referenceConfig
+    );
+    this.adapter = new ContentStorageAdapter(this.contentStorage);
+    this.resolver = new ContentResolver(this.adapter);
   }
   /**
-   * Detect the format of an entity string with API-based verification and fallback
+   * Initialize and register content storage for cross-package access
    */
-  async detectFormatWithFallback(entity, context) {
-    if (entity.startsWith("hcs://")) {
-      return EntityFormat.HRL;
+  async initialize() {
+    if (this.isRegistered) {
+      this.logger.warn("ContentStoreManager is already initialized");
+      return;
     }
-    if (/^0\.0\.\d+$/.test(entity)) {
-      const cached = this.getCachedFormat(entity);
-      if (cached) {
-        return cached;
+    try {
+      if (ContentStoreService && typeof ContentStoreService.setInstance === "function") {
+        await ContentStoreService.setInstance(
+          this.adapter
+        );
+      } else {
+        this.logger.warn("ContentStoreService.setInstance is unavailable; skipping registration");
       }
-      try {
-        const detected = await this.detectFormat(entity, context || {});
-        if (detected !== EntityFormat.ANY) {
-          this.setCachedFormat(entity, detected);
-          return detected;
-        }
-      } catch (error) {
-        this.logger.warn(
-          `Entity detection failed for ${entity}, using fallback: ${error.message}`
+      if (ContentResolverRegistry && typeof ContentResolverRegistry.register === "function") {
+        ContentResolverRegistry.register(
+          this.resolver
         );
+      } else {
+        this.logger.warn("ContentResolverRegistry.register is unavailable; skipping registration");
       }
-      return EntityFormat.ANY;
+      this.isRegistered = true;
+      this.logger.info(
+        "ContentStoreManager initialized and registered for cross-package access"
+      );
+    } catch (error) {
+      this.logger.error("Failed to initialize ContentStoreManager:", error);
+      throw error;
     }
-    return EntityFormat.ANY;
-  }
-  /**
-   * Public helper: detect entity format (ACCOUNT_ID, TOKEN_ID, TOPIC_ID, HRL, or ANY)
-   */
-  async detectEntityFormat(entity, context) {
-    return this.detectFormatWithFallback(entity, context);
   }
   /**
-   * Detect entity format via Hedera Mirror Node API calls
+   * Get the underlying ContentStorage instance
    */
-  async detectFormat(entity, context) {
-    const networkType = context.networkType || "testnet";
-    const mirrorNode = new HederaMirrorNode(networkType, this.logger);
-    mirrorNode.configureRetry({
-      maxRetries: 3,
-      maxDelayMs: 1e3
-    });
-    const checks = await Promise.allSettled([
-      mirrorNode.getAccountBalance(entity).then((result) => result !== null ? EntityFormat.ACCOUNT_ID : null).catch(() => null),
-      mirrorNode.getTokenInfo(entity).then((result) => result !== null ? EntityFormat.TOKEN_ID : null).catch(() => null),
-      mirrorNode.getTopicInfo(entity).then((result) => result !== null ? EntityFormat.TOPIC_ID : null).catch(() => null),
-      mirrorNode.getContract(entity).then((result) => result !== null ? EntityFormat.CONTRACT_ID : null).catch(() => null)
-    ]);
-    const successful = checks.find(
-      (result) => result.status === "fulfilled" && result.value !== null
-    );
-    return successful && successful.status === "fulfilled" ? successful.value : EntityFormat.ANY;
+  getContentStorage() {
+    return this.contentStorage;
   }
   /**
-   * Get cached entity format if valid
+   * Get storage statistics
    */
-  getCachedFormat(entity) {
-    const entry = this.entityTypeCache.get(entity);
-    if (!entry || this.isCacheExpired(entry)) {
-      this.entityTypeCache.delete(entity);
-      return null;
-    }
-    return entry.format;
+  async getStats() {
+    return await this.contentStorage.getStats();
   }
   /**
-   * Set cached entity format
+   * Update configuration
    */
-  setCachedFormat(entity, format) {
-    this.entityTypeCache.set(entity, {
-      format,
-      timestamp: Date.now(),
-      ttl: this.defaultCacheTTL
-    });
+  async updateConfig(config) {
+    return await this.contentStorage.updateConfig(config);
   }
   /**
-   * Check if cache entry is expired
+   * Perform manual cleanup
    */
-  isCacheExpired(entry) {
-    return Date.now() - entry.timestamp > entry.ttl;
+  async performCleanup() {
+    return await this.contentStorage.performCleanup();
   }
   /**
-   * Get all registered converters
+   * Check if content should be stored as reference
    */
-  getRegisteredConverters() {
-    return Array.from(this.converters.keys()).map((key) => {
-      const [source, target] = key.split("→");
-      return {
-        source,
-        target
-      };
-    });
+  shouldUseReference(content) {
+    return this.contentStorage.shouldUseReference(content);
   }
   /**
-   * Check if a converter exists for the given formats
+   * Store content if it's large enough
    */
-  hasConverter(source, target) {
-    return this.findConverter(source, target) !== null;
+  async storeContentIfLarge(content, metadata) {
+    const storeMetadata = {
+      source: "system",
+      contentType: "binary",
+      ...metadata
+    };
+    return await this.contentStorage.storeContentIfLarge(
+      content,
+      storeMetadata
+    );
   }
   /**
-   * Clear all registered converters
+   * Cleanup and unregister
    */
-  clear() {
-    this.converters.clear();
+  async dispose() {
+    if (this.isRegistered) {
+      this.contentStorage.dispose();
+      if (ContentStoreService && typeof ContentStoreService.dispose === "function") {
+        ContentStoreService.dispose();
+      }
+      if (ContentResolverRegistry && typeof ContentResolverRegistry.unregister === "function") {
+        ContentResolverRegistry.unregister();
+      }
+      this.isRegistered = false;
+      this.logger.info("ContentStoreManager disposed and unregistered");
+    }
   }
   /**
-   * Clear entity type cache
+   * Check if the manager is initialized
    */
-  clearCache() {
-    this.entityTypeCache.clear();
+  isInitialized() {
+    return this.isRegistered;
   }
 }
 export {
-  FormatConverterRegistry
+  ContentStoreManager
 };
 //# sourceMappingURL=index25.js.map

package/dist/esm/index25.js.map

@@ -1 +1 @@
-{"version":3,"file":"index25.js","sources":["../../src/services/formatters/format-converter-registry.ts"],"sourcesContent":["import { EntityFormat, FormatConverter, ConversionContext } from './types';\nimport {\n  HederaMirrorNode,\n  Logger,\n  NetworkType,\n} from '@hashgraphonline/standards-sdk';\n\ninterface CacheEntry {\n  format: EntityFormat;\n  timestamp: number;\n  ttl: number;\n}\n\n/**\n * Registry for format converters that handles entity transformation\n */\nexport class FormatConverterRegistry {\n  private converters = new Map<string, FormatConverter<unknown, unknown>>();\n  private entityTypeCache = new Map<string, CacheEntry>();\n  private logger = new Logger({ module: 'FormatConverterRegistry' });\n  private defaultCacheTTL = 5 * 60 * 1000;\n\n  /**\n   * Register a format converter\n   */\n  register<TSource, TTarget>(\n    converter: FormatConverter<TSource, TTarget>\n  ): void {\n    const key = `${converter.sourceFormat}→${converter.targetFormat}`;\n    this.converters.set(key, converter as FormatConverter<unknown, unknown>);\n  }\n\n  /**\n   * Find a converter for the given source and target formats\n   */\n  findConverter(\n    source: EntityFormat,\n    target: EntityFormat\n  ): FormatConverter<unknown, unknown> | null {\n    const key = `${source}→${target}`;\n    return this.converters.get(key) || null;\n  }\n\n  /**\n   * Convert an entity to the target format\n   */\n  async convertEntity(\n    entity: string,\n    target: EntityFormat,\n    context: ConversionContext\n  ): Promise<string> {\n    const sourceFormat = await this.detectFormatWithFallback(entity, context);\n    if (sourceFormat === target) {\n      return entity;\n    }\n\n    const converter = this.findConverter(sourceFormat, target);\n    if (!converter) {\n      throw new Error(`No converter found for ${sourceFormat} → ${target}`);\n    }\n\n    if (!converter.canConvert(entity, context)) {\n      throw new Error(`Converter cannot handle entity: ${entity}`);\n    }\n\n    const result = await converter.convert(entity, context);\n    return result as string;\n  }\n\n  /**\n   * Detect the format of an entity string with API-based verification and fallback\n   */\n  private async detectFormatWithFallback(\n    entity: string,\n    context?: ConversionContext\n  ): Promise<EntityFormat> {\n    if (entity.startsWith('hcs://')) {\n      return EntityFormat.HRL;\n    }\n\n    if (/^0\\.0\\.\\d+$/.test(entity)) {\n      const cached = this.getCachedFormat(entity);\n      if (cached) {\n        return cached;\n      }\n\n      try {\n        const detected = await this.detectFormat(entity, context || {});\n        if (detected !== EntityFormat.ANY) {\n          this.setCachedFormat(entity, detected);\n          return detected;\n        }\n      } catch (error) {\n        this.logger.warn(\n          `Entity detection failed for ${entity}, using fallback: ${\n            (error as Error).message\n          }`\n        );\n      }\n\n      return EntityFormat.ANY;\n    }\n\n    return EntityFormat.ANY;\n  }\n\n  /**\n   * Public helper: detect entity format (ACCOUNT_ID, TOKEN_ID, TOPIC_ID, HRL, or ANY)\n   */\n  async detectEntityFormat(\n    entity: string,\n    context?: ConversionContext\n  ): Promise<EntityFormat> {\n    return this.detectFormatWithFallback(entity, context);\n  }\n\n  /**\n   * Detect entity format via Hedera Mirror Node API calls\n   */\n  private async detectFormat(\n    entity: string,\n    context: ConversionContext\n  ): Promise<EntityFormat> {\n    const networkType = (context.networkType as NetworkType) || 'testnet';\n    const mirrorNode = new HederaMirrorNode(networkType, this.logger);\n\n    mirrorNode.configureRetry({\n      maxRetries: 3,\n      maxDelayMs: 1000,\n    });\n\n    const checks = await Promise.allSettled([\n      mirrorNode\n        .getAccountBalance(entity)\n        .then((result) => (result !== null ? EntityFormat.ACCOUNT_ID : null))\n        .catch(() => null),\n\n      mirrorNode\n        .getTokenInfo(entity)\n        .then((result) => (result !== null ? EntityFormat.TOKEN_ID : null))\n        .catch(() => null),\n\n      mirrorNode\n        .getTopicInfo(entity)\n        .then((result) => (result !== null ? EntityFormat.TOPIC_ID : null))\n        .catch(() => null),\n\n      mirrorNode\n        .getContract(entity)\n        .then((result) => (result !== null ? EntityFormat.CONTRACT_ID : null))\n        .catch(() => null),\n    ]);\n\n    const successful = checks.find(\n      (result) => result.status === 'fulfilled' && result.value !== null\n    );\n\n    return successful && successful.status === 'fulfilled'\n      ? (successful.value as EntityFormat)\n      : EntityFormat.ANY;\n  }\n\n  /**\n   * Get cached entity format if valid\n   */\n  private getCachedFormat(entity: string): EntityFormat | null {\n    const entry = this.entityTypeCache.get(entity);\n    if (!entry || this.isCacheExpired(entry)) {\n      this.entityTypeCache.delete(entity);\n      return null;\n    }\n    return entry.format;\n  }\n\n  /**\n   * Set cached entity format\n   */\n  private setCachedFormat(entity: string, format: EntityFormat): void {\n    this.entityTypeCache.set(entity, {\n      format,\n      timestamp: Date.now(),\n      ttl: this.defaultCacheTTL,\n    });\n  }\n\n  /**\n   * Check if cache entry is expired\n   */\n  private isCacheExpired(entry: CacheEntry): boolean {\n    return Date.now() - entry.timestamp > entry.ttl;\n  }\n\n  /**\n   * Get all registered converters\n   */\n  getRegisteredConverters(): Array<{\n    source: EntityFormat;\n    target: EntityFormat;\n  }> {\n    return Array.from(this.converters.keys()).map((key) => {\n      const [source, target] = key.split('→');\n      return {\n        source: source as EntityFormat,\n        target: target as EntityFormat,\n      };\n    });\n  }\n\n  /**\n   * Check if a converter exists for the given formats\n   */\n  hasConverter(source: EntityFormat, target: EntityFormat): boolean {\n    return this.findConverter(source, target) !== null;\n  }\n\n  /**\n   * Clear all registered converters\n   */\n  clear(): void {\n    this.converters.clear();\n  }\n\n  /**\n   * Clear entity type cache\n   */\n  clearCache(): void {\n    this.entityTypeCache.clear();\n  }\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"index25.js","sources":["../../src/services/content-store-manager.ts"],"sourcesContent":["import { ContentStorage } from '../memory/content-storage';\nimport {\n  ContentStoreService,\n  extractReferenceId,\n  shouldUseReference,\n  ContentResolverRegistry,\n  type ContentStoreInterface,\n  type ContentResolverInterface,\n  type ReferenceResolutionResult,\n} from '@hashgraphonline/standards-sdk';\nimport type {\n  ContentReference,\n  ContentReferenceConfig,\n  ContentReferenceStats,\n} from '../types/content-reference';\nimport { Logger } from '@hashgraphonline/standards-sdk';\n\n/**\n * Content metadata interface for adapter compatibility\n */\ninterface AdapterContentMetadata {\n  mimeType?: string;\n  fileName?: string;\n  sizeBytes?: number;\n  [key: string]: unknown;\n}\n\n/**\n * Configuration interface for content storage\n */\ninterface ContentStoreConfig {\n  maxSize?: number;\n  enableCompression?: boolean;\n  [key: string]: unknown;\n}\n\n/**\n * Adapter to make ContentStorage compatible with ContentStoreInterface\n */\nclass ContentStorageAdapter implements ContentStoreInterface {\n  constructor(private storage: ContentStorage) {}\n\n  async storeContent(\n    content: Buffer,\n    metadata: AdapterContentMetadata\n  ): Promise<string> {\n    const storeMetadata = {\n      contentType: 'binary' as const,\n      sizeBytes: content.length,\n      source: 'system' as const,\n      ...metadata,\n    };\n    const contentRef = await this.storage.storeContent(content, storeMetadata);\n    return contentRef.referenceId;\n  }\n\n  async resolveReference(\n    referenceId: string\n  ): Promise<ReferenceResolutionResult> {\n    const result = await this.storage.resolveReference(referenceId);\n    if (result.success && result.content) {\n      const response: ReferenceResolutionResult = {\n        content: result.content,\n      };\n      if (result.metadata) {\n        response.metadata = {\n          ...(result.metadata.mimeType !== undefined && {\n            mimeType: result.metadata.mimeType,\n          }),\n          ...(result.metadata.fileName !== undefined && {\n            fileName: result.metadata.fileName,\n          }),\n          originalSize: result.metadata.sizeBytes,\n        };\n      }\n      return response;\n    } else {\n      throw new Error(result.error || 'Reference not found');\n    }\n  }\n\n  async hasReference(referenceId: string): Promise<boolean> {\n    return await this.storage.hasReference(referenceId);\n  }\n\n  async cleanupReference(referenceId: string): Promise<void> {\n    await this.storage.cleanupReference(referenceId);\n  }\n\n  async getStats(): Promise<unknown> {\n    return await this.storage.getStats();\n  }\n\n  async updateConfig(config: ContentStoreConfig): Promise<void> {\n    const referenceConfig = {\n      sizeThresholdBytes: config.maxSize || 10240,\n      enableAutoCleanup: config.enableCompression || true,\n      ...config,\n    };\n    return await this.storage.updateConfig(referenceConfig);\n  }\n\n  async performCleanup(): Promise<void> {\n    await this.storage.performCleanup();\n  }\n\n  async dispose(): Promise<void> {\n    return Promise.resolve(this.storage.dispose());\n  }\n}\n\n/**\n * Content resolver implementation for dependency injection\n */\nclass ContentResolver implements ContentResolverInterface {\n  constructor(private adapter: ContentStorageAdapter) {}\n\n  async resolveReference(\n    referenceId: string\n  ): Promise<ReferenceResolutionResult> {\n    return await this.adapter.resolveReference(referenceId);\n  }\n\n  shouldUseReference(content: string | Buffer): boolean {\n    return shouldUseReference(content);\n  }\n\n  extractReferenceId(input: string): string | null {\n    return extractReferenceId(input);\n  }\n}\n\n/**\n * Manages content store lifecycle and cross-package registration\n */\nexport class ContentStoreManager {\n  private contentStorage: ContentStorage;\n  private adapter: ContentStorageAdapter;\n  private resolver: ContentResolver;\n  private logger: Logger;\n  protected isRegistered = false;\n\n  constructor(\n    maxMessageStorage: number = 1000,\n    referenceConfig?: Partial<ContentReferenceConfig>,\n    logger?: Logger\n  ) {\n    this.logger = logger || new Logger({ module: 'ContentStoreManager' });\n\n    this.contentStorage = new ContentStorage(\n      maxMessageStorage,\n      referenceConfig\n    );\n    this.adapter = new ContentStorageAdapter(this.contentStorage);\n    this.resolver = new ContentResolver(this.adapter);\n  }\n\n  /**\n   * Initialize and register content storage for cross-package access\n   */\n  async initialize(): Promise<void> {\n    if (this.isRegistered) {\n      this.logger.warn('ContentStoreManager is already initialized');\n      return;\n    }\n\n    try {\n      if (\n        ContentStoreService &&\n        typeof (ContentStoreService as unknown as { setInstance?: Function }).setInstance === 'function'\n      ) {\n        await (ContentStoreService as unknown as { setInstance: (adapter: unknown) => Promise<void> }).setInstance(\n          this.adapter\n        );\n      } else {\n        this.logger.warn('ContentStoreService.setInstance is unavailable; skipping registration');\n      }\n      if (\n        ContentResolverRegistry &&\n        typeof (ContentResolverRegistry as unknown as { register?: Function }).register === 'function'\n      ) {\n        (ContentResolverRegistry as unknown as { register: (resolver: unknown) => void }).register(\n          this.resolver\n        );\n      } else {\n        this.logger.warn('ContentResolverRegistry.register is unavailable; skipping registration');\n      }\n      this.isRegistered = true;\n      this.logger.info(\n        'ContentStoreManager initialized and registered for cross-package access'\n      );\n    } catch (error) {\n      this.logger.error('Failed to initialize ContentStoreManager:', error);\n      throw error;\n    }\n  }\n\n  /**\n   * Get the underlying ContentStorage instance\n   */\n  getContentStorage(): ContentStorage {\n    return this.contentStorage;\n  }\n\n  /**\n   * Get storage statistics\n   */\n  async getStats(): Promise<ContentReferenceStats> {\n    return await this.contentStorage.getStats();\n  }\n\n  /**\n   * Update configuration\n   */\n  async updateConfig(config: Partial<ContentReferenceConfig>): Promise<void> {\n    return await this.contentStorage.updateConfig(config);\n  }\n\n  /**\n   * Perform manual cleanup\n   */\n  async performCleanup(): Promise<{ cleanedUp: number; errors: string[] }> {\n    return await this.contentStorage.performCleanup();\n  }\n\n  /**\n   * Check if content should be stored as reference\n   */\n  shouldUseReference(content: Buffer | string): boolean {\n    return this.contentStorage.shouldUseReference(content);\n  }\n\n  /**\n   * Store content if it's large enough\n   */\n  async storeContentIfLarge(\n    content: Buffer | string,\n    metadata: AdapterContentMetadata\n  ): Promise<ContentReference | null> {\n    const storeMetadata = {\n      source: 'system' as const,\n      contentType: 'binary' as const,\n      ...metadata,\n    };\n    return await this.contentStorage.storeContentIfLarge(\n      content,\n      storeMetadata\n    );\n  }\n\n  /**\n   * Cleanup and unregister\n   */\n  async dispose(): Promise<void> {\n    if (this.isRegistered) {\n      this.contentStorage.dispose();\n      if (\n        ContentStoreService &&\n        typeof (ContentStoreService as unknown as { dispose?: Function }).dispose === 'function'\n      ) {\n        (ContentStoreService as unknown as { dispose: () => void }).dispose();\n      }\n      if (\n        ContentResolverRegistry &&\n        typeof (ContentResolverRegistry as unknown as { unregister?: Function }).unregister === 'function'\n      ) {\n        (ContentResolverRegistry as unknown as { unregister: () => void }).unregister();\n      }\n      this.isRegistered = false;\n      this.logger.info('ContentStoreManager disposed and unregistered');\n    }\n  }\n\n  /**\n   * Check if the manager is initialized\n   */\n  isInitialized(): boolean {\n    return this.isRegistered;\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/esm/index26.js

@@ -1,21 +1,157 @@
-var EntityFormat = /* @__PURE__ */ ((EntityFormat2) => {
-  EntityFormat2["TOPIC_ID"] = "topicId";
-  EntityFormat2["HRL"] = "hrl";
-  EntityFormat2["SCHEDULE_ID"] = "scheduleId";
-  EntityFormat2["TOKEN_ID"] = "tokenId";
-  EntityFormat2["ADDRESS"] = "address";
-  EntityFormat2["SYMBOL"] = "symbol";
-  EntityFormat2["SERIAL_NUMBER"] = "serialNumber";
-  EntityFormat2["METADATA"] = "metadata";
-  EntityFormat2["ACCOUNT_ID"] = "accountId";
-  EntityFormat2["ALIAS"] = "alias";
-  EntityFormat2["EVM_ADDRESS"] = "evmAddress";
-  EntityFormat2["CONTRACT_ID"] = "contractId";
-  EntityFormat2["FILE_ID"] = "fileId";
-  EntityFormat2["ANY"] = "any";
-  return EntityFormat2;
-})(EntityFormat || {});
+import { EntityFormat } from "./index27.js";
+import { Logger, HederaMirrorNode } from "@hashgraphonline/standards-sdk";
+class FormatConverterRegistry {
+  constructor() {
+    this.converters = /* @__PURE__ */ new Map();
+    this.entityTypeCache = /* @__PURE__ */ new Map();
+    this.logger = new Logger({ module: "FormatConverterRegistry" });
+    this.defaultCacheTTL = 5 * 60 * 1e3;
+  }
+  /**
+   * Register a format converter
+   */
+  register(converter) {
+    const key = `${converter.sourceFormat}→${converter.targetFormat}`;
+    this.converters.set(key, converter);
+  }
+  /**
+   * Find a converter for the given source and target formats
+   */
+  findConverter(source, target) {
+    const key = `${source}→${target}`;
+    return this.converters.get(key) || null;
+  }
+  /**
+   * Convert an entity to the target format
+   */
+  async convertEntity(entity, target, context) {
+    const sourceFormat = await this.detectFormatWithFallback(entity, context);
+    if (sourceFormat === target) {
+      return entity;
+    }
+    const converter = this.findConverter(sourceFormat, target);
+    if (!converter) {
+      throw new Error(`No converter found for ${sourceFormat} → ${target}`);
+    }
+    if (!converter.canConvert(entity, context)) {
+      throw new Error(`Converter cannot handle entity: ${entity}`);
+    }
+    const result = await converter.convert(entity, context);
+    return result;
+  }
+  /**
+   * Detect the format of an entity string with API-based verification and fallback
+   */
+  async detectFormatWithFallback(entity, context) {
+    if (entity.startsWith("hcs://")) {
+      return EntityFormat.HRL;
+    }
+    if (/^0\.0\.\d+$/.test(entity)) {
+      const cached = this.getCachedFormat(entity);
+      if (cached) {
+        return cached;
+      }
+      try {
+        const detected = await this.detectFormat(entity, context || {});
+        if (detected !== EntityFormat.ANY) {
+          this.setCachedFormat(entity, detected);
+          return detected;
+        }
+      } catch (error) {
+        this.logger.warn(
+          `Entity detection failed for ${entity}, using fallback: ${error.message}`
+        );
+      }
+      return EntityFormat.ANY;
+    }
+    return EntityFormat.ANY;
+  }
+  /**
+   * Public helper: detect entity format (ACCOUNT_ID, TOKEN_ID, TOPIC_ID, HRL, or ANY)
+   */
+  async detectEntityFormat(entity, context) {
+    return this.detectFormatWithFallback(entity, context);
+  }
+  /**
+   * Detect entity format via Hedera Mirror Node API calls
+   */
+  async detectFormat(entity, context) {
+    const networkType = context.networkType || "testnet";
+    const mirrorNode = new HederaMirrorNode(networkType, this.logger);
+    mirrorNode.configureRetry({
+      maxRetries: 3,
+      maxDelayMs: 1e3
+    });
+    const checks = await Promise.allSettled([
+      mirrorNode.getAccountBalance(entity).then((result) => result !== null ? EntityFormat.ACCOUNT_ID : null).catch(() => null),
+      mirrorNode.getTokenInfo(entity).then((result) => result !== null ? EntityFormat.TOKEN_ID : null).catch(() => null),
+      mirrorNode.getTopicInfo(entity).then((result) => result !== null ? EntityFormat.TOPIC_ID : null).catch(() => null),
+      mirrorNode.getContract(entity).then((result) => result !== null ? EntityFormat.CONTRACT_ID : null).catch(() => null)
+    ]);
+    const successful = checks.find(
+      (result) => result.status === "fulfilled" && result.value !== null
+    );
+    return successful && successful.status === "fulfilled" ? successful.value : EntityFormat.ANY;
+  }
+  /**
+   * Get cached entity format if valid
+   */
+  getCachedFormat(entity) {
+    const entry = this.entityTypeCache.get(entity);
+    if (!entry || this.isCacheExpired(entry)) {
+      this.entityTypeCache.delete(entity);
+      return null;
+    }
+    return entry.format;
+  }
+  /**
+   * Set cached entity format
+   */
+  setCachedFormat(entity, format) {
+    this.entityTypeCache.set(entity, {
+      format,
+      timestamp: Date.now(),
+      ttl: this.defaultCacheTTL
+    });
+  }
+  /**
+   * Check if cache entry is expired
+   */
+  isCacheExpired(entry) {
+    return Date.now() - entry.timestamp > entry.ttl;
+  }
+  /**
+   * Get all registered converters
+   */
+  getRegisteredConverters() {
+    return Array.from(this.converters.keys()).map((key) => {
+      const [source, target] = key.split("→");
+      return {
+        source,
+        target
+      };
+    });
+  }
+  /**
+   * Check if a converter exists for the given formats
+   */
+  hasConverter(source, target) {
+    return this.findConverter(source, target) !== null;
+  }
+  /**
+   * Clear all registered converters
+   */
+  clear() {
+    this.converters.clear();
+  }
+  /**
+   * Clear entity type cache
+   */
+  clearCache() {
+    this.entityTypeCache.clear();
+  }
+}
 export {
-  EntityFormat
+  FormatConverterRegistry
 };
 //# sourceMappingURL=index26.js.map

package/dist/esm/index26.js.map

@@ -1 +1 @@
-{"version":3,"file":"index26.js","sources":["../../src/services/formatters/types.ts"],"sourcesContent":["import { NetworkType } from '@hashgraphonline/standards-sdk';\n\nexport enum EntityFormat {\n  TOPIC_ID = 'topicId',\n  HRL = 'hrl',\n  SCHEDULE_ID = 'scheduleId',\n  TOKEN_ID = 'tokenId',\n  ADDRESS = 'address',\n  SYMBOL = 'symbol',\n  SERIAL_NUMBER = 'serialNumber',\n  METADATA = 'metadata',\n  ACCOUNT_ID = 'accountId',\n  ALIAS = 'alias',\n  EVM_ADDRESS = 'evmAddress',\n  CONTRACT_ID = 'contractId',\n  FILE_ID = 'fileId',\n  ANY = 'any'\n}\n\nexport interface ConversionContext {\n  networkType?: NetworkType;\n  sessionId?: string;\n  toolName?: string;\n  toolPreferences?: Record<string, string>;\n  [key: string]: unknown;\n}\n\nexport interface FormatConverter<TSource = string, TTarget = string> {\n  sourceFormat: EntityFormat;\n  targetFormat: EntityFormat;\n  canConvert(source: string, context: ConversionContext): boolean;\n  convert(entity: TSource, context: ConversionContext): Promise<TTarget>;\n}"],"names":["EntityFormat"],"mappings":"AAEO,IAAK,iCAAAA,kBAAL;AACLA,gBAAA,UAAA,IAAW;AACXA,gBAAA,KAAA,IAAM;AACNA,gBAAA,aAAA,IAAc;AACdA,gBAAA,UAAA,IAAW;AACXA,gBAAA,SAAA,IAAU;AACVA,gBAAA,QAAA,IAAS;AACTA,gBAAA,eAAA,IAAgB;AAChBA,gBAAA,UAAA,IAAW;AACXA,gBAAA,YAAA,IAAa;AACbA,gBAAA,OAAA,IAAQ;AACRA,gBAAA,aAAA,IAAc;AACdA,gBAAA,aAAA,IAAc;AACdA,gBAAA,SAAA,IAAU;AACVA,gBAAA,KAAA,IAAM;AAdI,SAAAA;AAAA,GAAA,gBAAA,CAAA,CAAA;"}
+{"version":3,"file":"index26.js","sources":["../../src/services/formatters/format-converter-registry.ts"],"sourcesContent":["import { EntityFormat, FormatConverter, ConversionContext } from './types';\nimport {\n  HederaMirrorNode,\n  Logger,\n  NetworkType,\n} from '@hashgraphonline/standards-sdk';\n\ninterface CacheEntry {\n  format: EntityFormat;\n  timestamp: number;\n  ttl: number;\n}\n\n/**\n * Registry for format converters that handles entity transformation\n */\nexport class FormatConverterRegistry {\n  private converters = new Map<string, FormatConverter<unknown, unknown>>();\n  private entityTypeCache = new Map<string, CacheEntry>();\n  private logger = new Logger({ module: 'FormatConverterRegistry' });\n  private defaultCacheTTL = 5 * 60 * 1000;\n\n  /**\n   * Register a format converter\n   */\n  register<TSource, TTarget>(\n    converter: FormatConverter<TSource, TTarget>\n  ): void {\n    const key = `${converter.sourceFormat}→${converter.targetFormat}`;\n    this.converters.set(key, converter as FormatConverter<unknown, unknown>);\n  }\n\n  /**\n   * Find a converter for the given source and target formats\n   */\n  findConverter(\n    source: EntityFormat,\n    target: EntityFormat\n  ): FormatConverter<unknown, unknown> | null {\n    const key = `${source}→${target}`;\n    return this.converters.get(key) || null;\n  }\n\n  /**\n   * Convert an entity to the target format\n   */\n  async convertEntity(\n    entity: string,\n    target: EntityFormat,\n    context: ConversionContext\n  ): Promise<string> {\n    const sourceFormat = await this.detectFormatWithFallback(entity, context);\n    if (sourceFormat === target) {\n      return entity;\n    }\n\n    const converter = this.findConverter(sourceFormat, target);\n    if (!converter) {\n      throw new Error(`No converter found for ${sourceFormat} → ${target}`);\n    }\n\n    if (!converter.canConvert(entity, context)) {\n      throw new Error(`Converter cannot handle entity: ${entity}`);\n    }\n\n    const result = await converter.convert(entity, context);\n    return result as string;\n  }\n\n  /**\n   * Detect the format of an entity string with API-based verification and fallback\n   */\n  private async detectFormatWithFallback(\n    entity: string,\n    context?: ConversionContext\n  ): Promise<EntityFormat> {\n    if (entity.startsWith('hcs://')) {\n      return EntityFormat.HRL;\n    }\n\n    if (/^0\\.0\\.\\d+$/.test(entity)) {\n      const cached = this.getCachedFormat(entity);\n      if (cached) {\n        return cached;\n      }\n\n      try {\n        const detected = await this.detectFormat(entity, context || {});\n        if (detected !== EntityFormat.ANY) {\n          this.setCachedFormat(entity, detected);\n          return detected;\n        }\n      } catch (error) {\n        this.logger.warn(\n          `Entity detection failed for ${entity}, using fallback: ${\n            (error as Error).message\n          }`\n        );\n      }\n\n      return EntityFormat.ANY;\n    }\n\n    return EntityFormat.ANY;\n  }\n\n  /**\n   * Public helper: detect entity format (ACCOUNT_ID, TOKEN_ID, TOPIC_ID, HRL, or ANY)\n   */\n  async detectEntityFormat(\n    entity: string,\n    context?: ConversionContext\n  ): Promise<EntityFormat> {\n    return this.detectFormatWithFallback(entity, context);\n  }\n\n  /**\n   * Detect entity format via Hedera Mirror Node API calls\n   */\n  private async detectFormat(\n    entity: string,\n    context: ConversionContext\n  ): Promise<EntityFormat> {\n    const networkType = (context.networkType as NetworkType) || 'testnet';\n    const mirrorNode = new HederaMirrorNode(networkType, this.logger);\n\n    mirrorNode.configureRetry({\n      maxRetries: 3,\n      maxDelayMs: 1000,\n    });\n\n    const checks = await Promise.allSettled([\n      mirrorNode\n        .getAccountBalance(entity)\n        .then((result) => (result !== null ? EntityFormat.ACCOUNT_ID : null))\n        .catch(() => null),\n\n      mirrorNode\n        .getTokenInfo(entity)\n        .then((result) => (result !== null ? EntityFormat.TOKEN_ID : null))\n        .catch(() => null),\n\n      mirrorNode\n        .getTopicInfo(entity)\n        .then((result) => (result !== null ? EntityFormat.TOPIC_ID : null))\n        .catch(() => null),\n\n      mirrorNode\n        .getContract(entity)\n        .then((result) => (result !== null ? EntityFormat.CONTRACT_ID : null))\n        .catch(() => null),\n    ]);\n\n    const successful = checks.find(\n      (result) => result.status === 'fulfilled' && result.value !== null\n    );\n\n    return successful && successful.status === 'fulfilled'\n      ? (successful.value as EntityFormat)\n      : EntityFormat.ANY;\n  }\n\n  /**\n   * Get cached entity format if valid\n   */\n  private getCachedFormat(entity: string): EntityFormat | null {\n    const entry = this.entityTypeCache.get(entity);\n    if (!entry || this.isCacheExpired(entry)) {\n      this.entityTypeCache.delete(entity);\n      return null;\n    }\n    return entry.format;\n  }\n\n  /**\n   * Set cached entity format\n   */\n  private setCachedFormat(entity: string, format: EntityFormat): void {\n    this.entityTypeCache.set(entity, {\n      format,\n      timestamp: Date.now(),\n      ttl: this.defaultCacheTTL,\n    });\n  }\n\n  /**\n   * Check if cache entry is expired\n   */\n  private isCacheExpired(entry: CacheEntry): boolean {\n    return Date.now() - entry.timestamp > entry.ttl;\n  }\n\n  /**\n   * Get all registered converters\n   */\n  getRegisteredConverters(): Array<{\n    source: EntityFormat;\n    target: EntityFormat;\n  }> {\n    return Array.from(this.converters.keys()).map((key) => {\n      const [source, target] = key.split('→');\n      return {\n        source: source as EntityFormat,\n        target: target as EntityFormat,\n      };\n    });\n  }\n\n  /**\n   * Check if a converter exists for the given formats\n   */\n  hasConverter(source: EntityFormat, target: EntityFormat): boolean {\n    return this.findConverter(source, target) !== null;\n  }\n\n  /**\n   * Clear all registered converters\n   */\n  clear(): void {\n    this.converters.clear();\n  }\n\n  /**\n   * Clear entity type cache\n   */\n  clearCache(): void {\n    this.entityTypeCache.clear();\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/esm/index27.js

@@ -1,25 +1,21 @@
-import { EntityFormat } from "./index26.js";
-class TopicIdToHrlConverter {
-  constructor() {
-    this.sourceFormat = EntityFormat.TOPIC_ID;
-    this.targetFormat = EntityFormat.HRL;
-  }
-  /**
-   * Check if the source string is a valid topic ID
-   */
-  canConvert(source, _context) {
-    return /^0\.0\.\d+$/.test(source);
-  }
-  /**
-   * Convert topic ID to HRL format based on network type
-   */
-  async convert(topicId, context) {
-    const networkType = context.networkType || "testnet";
-    const networkId = networkType === "mainnet" ? "0" : "1";
-    return `hcs://${networkId}/${topicId}`;
-  }
-}
+var EntityFormat = /* @__PURE__ */ ((EntityFormat2) => {
+  EntityFormat2["TOPIC_ID"] = "topicId";
+  EntityFormat2["HRL"] = "hrl";
+  EntityFormat2["SCHEDULE_ID"] = "scheduleId";
+  EntityFormat2["TOKEN_ID"] = "tokenId";
+  EntityFormat2["ADDRESS"] = "address";
+  EntityFormat2["SYMBOL"] = "symbol";
+  EntityFormat2["SERIAL_NUMBER"] = "serialNumber";
+  EntityFormat2["METADATA"] = "metadata";
+  EntityFormat2["ACCOUNT_ID"] = "accountId";
+  EntityFormat2["ALIAS"] = "alias";
+  EntityFormat2["EVM_ADDRESS"] = "evmAddress";
+  EntityFormat2["CONTRACT_ID"] = "contractId";
+  EntityFormat2["FILE_ID"] = "fileId";
+  EntityFormat2["ANY"] = "any";
+  return EntityFormat2;
+})(EntityFormat || {});
 export {
-  TopicIdToHrlConverter
+  EntityFormat
 };
 //# sourceMappingURL=index27.js.map

package/dist/esm/index27.js.map

@@ -1 +1 @@
-{"version":3,"file":"index27.js","sources":["../../src/services/formatters/converters/topic-id-to-hrl-converter.ts"],"sourcesContent":["import { EntityFormat, FormatConverter, ConversionContext } from '../types';\n\n/**\n * Converts Hedera topic IDs to HRL format for consensus service messages\n */\nexport class TopicIdToHrlConverter implements FormatConverter<string, string> {\n  sourceFormat = EntityFormat.TOPIC_ID;\n  targetFormat = EntityFormat.HRL;\n\n  /**\n   * Check if the source string is a valid topic ID\n   */\n  canConvert(source: string, _context: ConversionContext): boolean {\n    return /^0\\.0\\.\\d+$/.test(source);\n  }\n\n  /**\n   * Convert topic ID to HRL format based on network type\n   */\n  async convert(topicId: string, context: ConversionContext): Promise<string> {\n    const networkType = context.networkType || 'testnet';\n    const networkId = networkType === 'mainnet' ? '0' : '1';\n    return `hcs://${networkId}/${topicId}`;\n  }\n}\n"],"names":[],"mappings":";AAKO,MAAM,sBAAiE;AAAA,EAAvE,cAAA;AACL,SAAA,eAAe,aAAa;AAC5B,SAAA,eAAe,aAAa;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA,EAK5B,WAAW,QAAgB,UAAsC;AAC/D,WAAO,cAAc,KAAK,MAAM;AAAA,EAClC;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,QAAQ,SAAiB,SAA6C;AAC1E,UAAM,cAAc,QAAQ,eAAe;AAC3C,UAAM,YAAY,gBAAgB,YAAY,MAAM;AACpD,WAAO,SAAS,SAAS,IAAI,OAAO;AAAA,EACtC;AACF;"}
+{"version":3,"file":"index27.js","sources":["../../src/services/formatters/types.ts"],"sourcesContent":["import { NetworkType } from '@hashgraphonline/standards-sdk';\n\nexport enum EntityFormat {\n  TOPIC_ID = 'topicId',\n  HRL = 'hrl',\n  SCHEDULE_ID = 'scheduleId',\n  TOKEN_ID = 'tokenId',\n  ADDRESS = 'address',\n  SYMBOL = 'symbol',\n  SERIAL_NUMBER = 'serialNumber',\n  METADATA = 'metadata',\n  ACCOUNT_ID = 'accountId',\n  ALIAS = 'alias',\n  EVM_ADDRESS = 'evmAddress',\n  CONTRACT_ID = 'contractId',\n  FILE_ID = 'fileId',\n  ANY = 'any'\n}\n\nexport interface ConversionContext {\n  networkType?: NetworkType;\n  sessionId?: string;\n  toolName?: string;\n  toolPreferences?: Record<string, string>;\n  [key: string]: unknown;\n}\n\nexport interface FormatConverter<TSource = string, TTarget = string> {\n  sourceFormat: EntityFormat;\n  targetFormat: EntityFormat;\n  canConvert(source: string, context: ConversionContext): boolean;\n  convert(entity: TSource, context: ConversionContext): Promise<TTarget>;\n}"],"names":["EntityFormat"],"mappings":"AAEO,IAAK,iCAAAA,kBAAL;AACLA,gBAAA,UAAA,IAAW;AACXA,gBAAA,KAAA,IAAM;AACNA,gBAAA,aAAA,IAAc;AACdA,gBAAA,UAAA,IAAW;AACXA,gBAAA,SAAA,IAAU;AACVA,gBAAA,QAAA,IAAS;AACTA,gBAAA,eAAA,IAAgB;AAChBA,gBAAA,UAAA,IAAW;AACXA,gBAAA,YAAA,IAAa;AACbA,gBAAA,OAAA,IAAQ;AACRA,gBAAA,aAAA,IAAc;AACdA,gBAAA,aAAA,IAAc;AACdA,gBAAA,SAAA,IAAU;AACVA,gBAAA,KAAA,IAAM;AAdI,SAAAA;AAAA,GAAA,gBAAA,CAAA,CAAA;"}