@hashgraphonline/standards-sdk 0.1.159 → 0.1.161

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

@@ -1,235 +1,148 @@
-var DiscoveryOperation = /* @__PURE__ */ ((DiscoveryOperation2) => {
-  DiscoveryOperation2["ANNOUNCE"] = "announce";
-  DiscoveryOperation2["PROPOSE"] = "propose";
-  DiscoveryOperation2["RESPOND"] = "respond";
-  DiscoveryOperation2["COMPLETE"] = "complete";
-  DiscoveryOperation2["WITHDRAW"] = "withdraw";
-  return DiscoveryOperation2;
-})(DiscoveryOperation || {});
-function isRecord(value) {
-  return typeof value === "object" && value !== null;
-}
-function isString(value) {
-  return typeof value === "string";
-}
-function isNumber(value) {
-  return typeof value === "number" && Number.isFinite(value);
-}
-function isArray(value) {
-  return Array.isArray(value);
-}
-function isArrayOfStrings(value) {
-  return Array.isArray(value) && value.every(isString);
-}
-function isDiscoveryMessage(value) {
-  if (!isRecord(value)) {
-    return false;
-  }
-  if (value.p !== "hcs-18") {
-    return false;
-  }
-  if (!isString(value.op)) {
-    return false;
-  }
-  const op = value.op;
-  if (!["announce", "propose", "respond", "complete", "withdraw"].includes(op)) {
-    return false;
-  }
-  return "data" in value;
-}
-function isAnnounceMessage(value) {
-  if (!isDiscoveryMessage(value)) {
-    return false;
-  }
-  const v = value;
-  if (v.op !== "announce") {
-    return false;
-  }
-  if (!isRecord(v.data)) {
-    return false;
-  }
-  const d = v.data;
-  if (!isString(d.account)) {
-    return false;
-  }
-  if (!isRecord(d.petal)) {
-    return false;
-  }
-  const petal = d.petal;
-  if (!isString(petal.name) || !isNumber(petal.priority)) {
-    return false;
-  }
-  if (!isRecord(d.capabilities)) {
-    return false;
-  }
-  const caps = d.capabilities;
-  if (!isArrayOfStrings(caps.protocols)) {
-    return false;
-  }
-  if ("valid_for" in d && d.valid_for !== void 0 && d.valid_for !== null && !isNumber(d.valid_for)) {
-    return false;
-  }
-  return true;
-}
-function isProposeMessage(value) {
-  if (!isDiscoveryMessage(value)) {
-    return false;
-  }
-  const v = value;
-  if (v.op !== "propose") {
-    return false;
-  }
-  if (!isRecord(v.data)) {
-    return false;
-  }
-  const d = v.data;
-  if (!isString(d.proposer)) {
-    return false;
-  }
-  if (!isArray(d.members)) {
-    return false;
+import { HederaMirrorNode } from "./standards-sdk.es138.js";
+import { KeyList } from "@hashgraph/sdk";
+import { buildHcs16CreateFloraTopicTx } from "./standards-sdk.es97.js";
+import { Logger } from "./standards-sdk.es117.js";
+import { FloraTopicType } from "./standards-sdk.es96.js";
+class HCS16BaseClient {
+  constructor(params) {
+    this.network = params.network;
+    this.logger = params.logger || new Logger({ level: "info", module: "HCS-16" });
+    this.mirrorNode = new HederaMirrorNode(this.network, this.logger, {
+      customUrl: params.mirrorNodeUrl
+    });
+  }
+  async assembleKeyList(params) {
+    const keys = [];
+    for (const accountId of params.members) {
+      const pub = await this.mirrorNode.getPublicKey(accountId);
+      keys.push(pub);
+    }
+    return new KeyList(keys, params.threshold);
   }
-  const membersOk = d.members.every((m) => {
-    if (!isRecord(m)) {
-      return false;
+  async assembleSubmitKeyList(members) {
+    const keys = [];
+    for (const accountId of members) {
+      const pub = await this.mirrorNode.getPublicKey(accountId);
+      keys.push(pub);
     }
-    const mr = m;
-    if (!isString(mr.account)) {
-      return false;
+    return new KeyList(keys, 1);
+  }
+  buildFloraTopicCreateTxs(params) {
+    const communication = buildHcs16CreateFloraTopicTx({
+      floraAccountId: params.floraAccountId,
+      topicType: FloraTopicType.COMMUNICATION,
+      adminKey: params.keyList,
+      submitKey: params.submitList,
+      autoRenewAccountId: params.autoRenewAccountId
+    });
+    const transaction = buildHcs16CreateFloraTopicTx({
+      floraAccountId: params.floraAccountId,
+      topicType: FloraTopicType.TRANSACTION,
+      adminKey: params.keyList,
+      submitKey: params.submitList,
+      autoRenewAccountId: params.autoRenewAccountId
+    });
+    const state = buildHcs16CreateFloraTopicTx({
+      floraAccountId: params.floraAccountId,
+      topicType: FloraTopicType.STATE,
+      adminKey: params.keyList,
+      submitKey: params.submitList,
+      autoRenewAccountId: params.autoRenewAccountId
+    });
+    return { communication, transaction, state };
+  }
+  /**
+   * Parse an HCS‑16 Flora topic memo of the form `hcs-16:<floraAccountId>:<topicType>`.
+   */
+  parseTopicMemo(memo) {
+    const match = memo.match(/^hcs-16:([0-9.]+):(\d)$/);
+    if (!match) {
+      return null;
     }
-    if (!("priority" in mr) || !isNumber(mr.priority)) {
-      return false;
+    const floraAccountId = match[1];
+    const topicType = Number(match[2]);
+    if (topicType !== FloraTopicType.COMMUNICATION && topicType !== FloraTopicType.TRANSACTION && topicType !== FloraTopicType.STATE) {
+      return null;
     }
-    if ("announce_seq" in mr && mr.announce_seq !== void 0 && mr.announce_seq !== null && !isNumber(mr.announce_seq)) {
-      return false;
+    return {
+      protocol: "hcs-16",
+      floraAccountId,
+      topicType
+    };
+  }
+  /**
+   * Build a Flora message envelope by merging an operation body into the HCS‑16 envelope.
+   */
+  createFloraMessage(op, operatorId, body) {
+    const payload = {
+      p: "hcs-16",
+      op,
+      operator_id: operatorId,
+      ...body || {}
+    };
+    return payload;
+  }
+  /**
+   * Fetch recent HCS‑16 messages from a topic via Mirror Node.
+   */
+  async getRecentMessages(topicId, options) {
+    const limit = options?.limit ?? 25;
+    const order = options?.order ?? "desc";
+    const items = await this.mirrorNode.getTopicMessages(topicId, { limit, order });
+    const results = [];
+    for (const raw of items) {
+      if (raw.p !== "hcs-16") {
+        continue;
+      }
+      const {
+        consensus_timestamp,
+        sequence_number,
+        running_hash,
+        running_hash_version,
+        topic_id,
+        payer,
+        created,
+        chunk_info,
+        ...payload
+      } = raw;
+      const op = payload.op;
+      const operatorId = payload.operator_id;
+      if (options?.opFilter && op !== options.opFilter) {
+        continue;
+      }
+      if (typeof operatorId !== "string") {
+        continue;
+      }
+      const message = payload;
+      results.push({
+        message,
+        consensus_timestamp,
+        sequence_number: Number(sequence_number),
+        payer
+      });
     }
-    return true;
-  });
-  if (!membersOk) {
-    return false;
-  }
-  if (!isRecord(d.config)) {
-    return false;
-  }
-  const cfg = d.config;
-  if (!isString(cfg.name) || !isNumber(cfg.threshold)) {
-    return false;
-  }
-  return true;
-}
-function isRespondMessage(value) {
-  if (!isDiscoveryMessage(value)) {
-    return false;
-  }
-  const v = value;
-  if (v.op !== "respond") {
-    return false;
-  }
-  if (!isRecord(v.data)) {
-    return false;
-  }
-  const d = v.data;
-  if (!isString(d.responder)) {
-    return false;
-  }
-  if (!isNumber(d.proposal_seq)) {
-    return false;
-  }
-  if (!isString(d.decision)) {
-    return false;
-  }
-  if (!["accept", "reject"].includes(d.decision)) {
-    return false;
-  }
-  return true;
-}
-function isCompleteMessage(value) {
-  if (!isDiscoveryMessage(value)) {
-    return false;
-  }
-  const v = value;
-  if (v.op !== "complete") {
-    return false;
-  }
-  if (!isRecord(v.data)) {
-    return false;
-  }
-  const d = v.data;
-  if (!isString(d.proposer)) {
-    return false;
-  }
-  if (!isNumber(d.proposal_seq)) {
-    return false;
-  }
-  if (!isString(d.flora_account)) {
-    return false;
-  }
-  if (!isRecord(d.topics)) {
-    return false;
-  }
-  const t = d.topics;
-  if (!isString(t.communication) || !isString(t.transaction) || !isString(t.state)) {
-    return false;
-  }
-  return true;
-}
-function isWithdrawMessage(value) {
-  if (!isDiscoveryMessage(value)) {
-    return false;
-  }
-  const v = value;
-  if (v.op !== "withdraw") {
-    return false;
-  }
-  if (!isRecord(v.data)) {
-    return false;
-  }
-  const d = v.data;
-  if (!isString(d.account)) {
-    return false;
-  }
-  if (!isNumber(d.announce_seq)) {
-    return false;
-  }
-  if ("reason" in d && d.reason !== void 0 && d.reason !== null && !isString(d.reason)) {
-    return false;
-  }
-  return true;
-}
-var DiscoveryState = /* @__PURE__ */ ((DiscoveryState2) => {
-  DiscoveryState2["IDLE"] = "idle";
-  DiscoveryState2["ANNOUNCED"] = "announced";
-  DiscoveryState2["PROPOSING"] = "proposing";
-  DiscoveryState2["FORMING"] = "forming";
-  DiscoveryState2["ACTIVE"] = "active";
-  DiscoveryState2["WITHDRAWN"] = "withdrawn";
-  return DiscoveryState2;
-})(DiscoveryState || {});
-class DiscoveryError extends Error {
-  constructor(message, code) {
-    super(message);
-    this.code = code;
-    this.name = "DiscoveryError";
+    return results;
+  }
+  /**
+   * Return the latest valid HCS‑16 message on a topic, if any.
+   */
+  async getLatestMessage(topicId, opFilter) {
+    const items = await this.getRecentMessages(topicId, {
+      limit: 1,
+      order: "desc",
+      opFilter
+    });
+    if (items.length === 0) {
+      return null;
+    }
+    const first = items[0];
+    return Object.assign({}, first.message, {
+      consensus_timestamp: first.consensus_timestamp,
+      sequence_number: first.sequence_number
+    });
   }
 }
-const DiscoveryErrorCodes = {
-  INVALID_MESSAGE: "INVALID_MESSAGE",
-  TIMEOUT: "TIMEOUT",
-  INSUFFICIENT_PETALS: "INSUFFICIENT_PETALS",
-  FLORA_CREATION_FAILED: "FLORA_CREATION_FAILED",
-  ALREADY_IN_DISCOVERY: "ALREADY_IN_DISCOVERY",
-  INVALID_STATE: "INVALID_STATE"
-};
 export {
-  DiscoveryError,
-  DiscoveryErrorCodes,
-  DiscoveryOperation,
-  DiscoveryState,
-  isAnnounceMessage,
-  isCompleteMessage,
-  isDiscoveryMessage,
-  isProposeMessage,
-  isRespondMessage,
-  isWithdrawMessage
+  HCS16BaseClient
 };
 //# sourceMappingURL=standards-sdk.es100.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"standards-sdk.es100.js","sources":["../../src/hcs-18/types.ts"],"sourcesContent":["/**\n * HCS-18 Flora Discovery Protocol Types\n * Standard for Flora discovery and formation\n */\n\nimport { TopicId } from '@hashgraph/sdk';\n\n/**\n * HCS-18 Operation types\n */\nexport enum DiscoveryOperation {\n  ANNOUNCE = 'announce',\n  PROPOSE = 'propose',\n  RESPOND = 'respond',\n  COMPLETE = 'complete',\n  WITHDRAW = 'withdraw',\n}\n\n/**\n * Base HCS-18 message structure\n */\nexport interface DiscoveryMessage {\n  p: 'hcs-18';\n  op: DiscoveryOperation;\n  data: any;\n}\n\n/**\n * Announce operation data\n */\nexport interface AnnounceData {\n  account: string;\n  petal: {\n    name: string;\n    priority: number;\n  };\n  capabilities: {\n    protocols: string[];\n    resources?: {\n      compute?: 'high' | 'medium' | 'low';\n      storage?: 'high' | 'medium' | 'low';\n      bandwidth?: 'high' | 'medium' | 'low';\n    };\n    group_preferences?: {\n      sizes?: number[];\n      threshold_ratios?: number[];\n    };\n  };\n  valid_for?: number;\n}\n\n/**\n * Propose operation data\n */\nexport interface ProposeData {\n  proposer: string;\n  members: Array<{\n    account: string;\n    announce_seq?: number;\n    priority: number;\n    status?: 'existing' | 'proposed';\n  }>;\n  config: {\n    name: string;\n    threshold: number;\n    purpose?: string;\n    reason?: string;\n  };\n  existing_flora?: string;\n}\n\n/**\n * Respond operation data\n */\nexport interface RespondData {\n  responder: string;\n  proposal_seq: number;\n  decision: 'accept' | 'reject';\n  reason?: string;\n  accepted_seq?: number;\n}\n\n/**\n * Complete operation data\n */\nexport interface CompleteData {\n  proposal_seq: number;\n  flora_account: string;\n  topics: {\n    communication: string;\n    transaction: string;\n    state: string;\n  };\n  proposer?: string;\n}\n\n/**\n * Withdraw operation data\n */\nexport interface WithdrawData {\n  account: string;\n  announce_seq: number;\n  reason?: string;\n}\n\n/**\n * Typed message operations\n */\nexport interface AnnounceMessage extends DiscoveryMessage {\n  op: DiscoveryOperation.ANNOUNCE;\n  data: AnnounceData;\n}\n\nexport interface ProposeMessage extends DiscoveryMessage {\n  op: DiscoveryOperation.PROPOSE;\n  data: ProposeData;\n}\n\nexport interface RespondMessage extends DiscoveryMessage {\n  op: DiscoveryOperation.RESPOND;\n  data: RespondData;\n}\n\nexport interface CompleteMessage extends DiscoveryMessage {\n  op: DiscoveryOperation.COMPLETE;\n  data: CompleteData;\n}\n\nexport interface WithdrawMessage extends DiscoveryMessage {\n  op: DiscoveryOperation.WITHDRAW;\n  data: WithdrawData;\n}\n\n/**\n * Type guard utilities for HCS-18 discovery messages\n */\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null;\n}\n\nfunction isString(value: unknown): value is string {\n  return typeof value === 'string';\n}\n\nfunction isNumber(value: unknown): value is number {\n  return typeof value === 'number' && Number.isFinite(value);\n}\n\nfunction isArray(value: unknown): value is unknown[] {\n  return Array.isArray(value);\n}\n\nfunction isArrayOfStrings(value: unknown): value is string[] {\n  return Array.isArray(value) && value.every(isString);\n}\n\nexport function isDiscoveryMessage(value: unknown): value is DiscoveryMessage {\n  if (!isRecord(value)) {\n    return false;\n  }\n  if (value.p !== 'hcs-18') {\n    return false;\n  }\n  if (!isString((value as Record<string, unknown>).op)) {\n    return false;\n  }\n  const op = (value as Record<string, unknown>).op as string;\n  if (\n    !['announce', 'propose', 'respond', 'complete', 'withdraw'].includes(op)\n  ) {\n    return false;\n  }\n  return 'data' in value;\n}\n\nexport function isAnnounceMessage(value: unknown): value is AnnounceMessage {\n  if (!isDiscoveryMessage(value)) {\n    return false;\n  }\n  const v = value as DiscoveryMessage;\n  if (v.op !== DiscoveryOperation.ANNOUNCE) {\n    return false;\n  }\n  if (!isRecord(v.data)) {\n    return false;\n  }\n  const d = v.data as Record<string, unknown>;\n  if (!isString(d.account)) {\n    return false;\n  }\n  if (!isRecord(d.petal)) {\n    return false;\n  }\n  const petal = d.petal as Record<string, unknown>;\n  if (!isString(petal.name) || !isNumber(petal.priority)) {\n    return false;\n  }\n  if (!isRecord(d.capabilities)) {\n    return false;\n  }\n  const caps = d.capabilities as Record<string, unknown>;\n  if (!isArrayOfStrings(caps.protocols)) {\n    return false;\n  }\n  if (\n    'valid_for' in d &&\n    d.valid_for !== undefined &&\n    d.valid_for !== null &&\n    !isNumber(d.valid_for)\n  ) {\n    return false;\n  }\n  return true;\n}\n\nexport function isProposeMessage(value: unknown): value is ProposeMessage {\n  if (!isDiscoveryMessage(value)) {\n    return false;\n  }\n  const v = value as DiscoveryMessage;\n  if (v.op !== DiscoveryOperation.PROPOSE) {\n    return false;\n  }\n  if (!isRecord(v.data)) {\n    return false;\n  }\n  const d = v.data as Record<string, unknown>;\n  if (!isString(d.proposer)) {\n    return false;\n  }\n  if (!isArray(d.members)) {\n    return false;\n  }\n  const membersOk = (d.members as unknown[]).every(m => {\n    if (!isRecord(m)) {\n      return false;\n    }\n    const mr = m as Record<string, unknown>;\n    if (!isString(mr.account)) {\n      return false;\n    }\n    if (!('priority' in mr) || !isNumber(mr.priority)) {\n      return false;\n    }\n    if (\n      'announce_seq' in mr &&\n      mr.announce_seq !== undefined &&\n      mr.announce_seq !== null &&\n      !isNumber(mr.announce_seq)\n    ) {\n      return false;\n    }\n    return true;\n  });\n  if (!membersOk) {\n    return false;\n  }\n  if (!isRecord(d.config)) {\n    return false;\n  }\n  const cfg = d.config as Record<string, unknown>;\n  if (!isString(cfg.name) || !isNumber(cfg.threshold)) {\n    return false;\n  }\n  return true;\n}\n\nexport function isRespondMessage(value: unknown): value is RespondMessage {\n  if (!isDiscoveryMessage(value)) {\n    return false;\n  }\n  const v = value as DiscoveryMessage;\n  if (v.op !== DiscoveryOperation.RESPOND) {\n    return false;\n  }\n  if (!isRecord(v.data)) {\n    return false;\n  }\n  const d = v.data as Record<string, unknown>;\n  if (!isString(d.responder)) {\n    return false;\n  }\n  if (!isNumber(d.proposal_seq)) {\n    return false;\n  }\n  if (!isString(d.decision)) {\n    return false;\n  }\n  if (!['accept', 'reject'].includes(d.decision as string)) {\n    return false;\n  }\n  return true;\n}\n\nexport function isCompleteMessage(value: unknown): value is CompleteMessage {\n  if (!isDiscoveryMessage(value)) {\n    return false;\n  }\n  const v = value as DiscoveryMessage;\n  if (v.op !== DiscoveryOperation.COMPLETE) {\n    return false;\n  }\n  if (!isRecord(v.data)) {\n    return false;\n  }\n  const d = v.data as Record<string, unknown>;\n  if (!isString(d.proposer)) {\n    return false;\n  }\n  if (!isNumber(d.proposal_seq)) {\n    return false;\n  }\n  if (!isString(d.flora_account)) {\n    return false;\n  }\n  if (!isRecord(d.topics)) {\n    return false;\n  }\n  const t = d.topics as Record<string, unknown>;\n  if (\n    !isString(t.communication) ||\n    !isString(t.transaction) ||\n    !isString(t.state)\n  ) {\n    return false;\n  }\n  return true;\n}\n\nexport function isWithdrawMessage(value: unknown): value is WithdrawMessage {\n  if (!isDiscoveryMessage(value)) {\n    return false;\n  }\n  const v = value as DiscoveryMessage;\n  if (v.op !== DiscoveryOperation.WITHDRAW) {\n    return false;\n  }\n  if (!isRecord(v.data)) {\n    return false;\n  }\n  const d = v.data as Record<string, unknown>;\n  if (!isString(d.account)) {\n    return false;\n  }\n  if (!isNumber(d.announce_seq)) {\n    return false;\n  }\n  if (\n    'reason' in d &&\n    d.reason !== undefined &&\n    d.reason !== null &&\n    !isString(d.reason)\n  ) {\n    return false;\n  }\n  return true;\n}\n\n/**\n * Discovery phase states\n */\nexport enum DiscoveryState {\n  IDLE = 'idle',\n  ANNOUNCED = 'announced',\n  PROPOSING = 'proposing',\n  FORMING = 'forming',\n  ACTIVE = 'active',\n  WITHDRAWN = 'withdrawn',\n}\n\n/**\n * Tracked announcement with HCS metadata\n */\nexport interface TrackedAnnouncement {\n  account: string;\n  sequenceNumber: number;\n  consensusTimestamp: string;\n  data: AnnounceData;\n}\n\n/**\n * Tracked proposal with HCS metadata\n */\nexport interface TrackedProposal {\n  sequenceNumber: number;\n  consensusTimestamp: string;\n  proposer: string;\n  data: ProposeData;\n  responses: Map<string, RespondData>;\n}\n\n/**\n * Flora formation result\n */\nexport interface FloraFormation {\n  proposalSeq: number;\n  floraAccountId: string;\n  topics: {\n    communication: string;\n    transaction: string;\n    state: string;\n  };\n  members: Array<{\n    account: string;\n    priority: number;\n  }>;\n  threshold: number;\n  createdAt: Date;\n}\n\n/**\n * Discovery event types for monitoring\n */\nexport interface DiscoveryEvent {\n  type:\n    | 'announcement_received'\n    | 'proposal_received'\n    | 'response_received'\n    | 'formation_complete'\n    | 'withdrawal_received'\n    | 'discovery_timeout';\n  sequenceNumber?: number;\n  timestamp: Date;\n  data: any;\n}\n\n/**\n * Discovery configuration\n */\nexport interface DiscoveryConfig {\n  discoveryTopicId: string | TopicId;\n  accountId: string;\n  petalName: string;\n  priority: number;\n  capabilities: {\n    protocols: string[];\n    resources?: AnnounceData['capabilities']['resources'];\n    group_preferences?: AnnounceData['capabilities']['group_preferences'];\n  };\n  autoAcceptFilter?: (proposal: TrackedProposal) => boolean;\n  onDiscoveryEvent?: (event: DiscoveryEvent) => void;\n  memberPrivateKeys?: Map<string, string>;\n}\n\n/**\n * HCS-18 Errors\n */\nexport class DiscoveryError extends Error {\n  constructor(\n    message: string,\n    public readonly code: string,\n  ) {\n    super(message);\n    this.name = 'DiscoveryError';\n  }\n}\n\nexport const DiscoveryErrorCodes = {\n  INVALID_MESSAGE: 'INVALID_MESSAGE',\n  TIMEOUT: 'TIMEOUT',\n  INSUFFICIENT_PETALS: 'INSUFFICIENT_PETALS',\n  FLORA_CREATION_FAILED: 'FLORA_CREATION_FAILED',\n  ALREADY_IN_DISCOVERY: 'ALREADY_IN_DISCOVERY',\n  INVALID_STATE: 'INVALID_STATE',\n} as const;\n"],"names":["DiscoveryOperation","DiscoveryState"],"mappings":"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"}
+{"version":3,"file":"standards-sdk.es100.js","sources":["../../src/hcs-16/base-client.ts"],"sourcesContent":["import { HederaMirrorNode } from '../services/mirror-node';\nimport { KeyList, TopicCreateTransaction, PublicKey } from '@hashgraph/sdk';\nimport { buildHcs16CreateFloraTopicTx } from './tx';\nimport { Logger, ILogger } from '../utils/logger';\nimport { NetworkType } from '../utils/types';\nimport { FloraTopicType, FloraMessage, FloraOperation } from './types';\nimport type { HCSMessageWithCommonFields } from '../services/types';\n\n/**\n * Base client for HCS‑16 functionality. Provides logging, mirror‑node access,\n * memo helpers, and light message utilities shared by Node and Browser clients.\n */\nexport class HCS16BaseClient {\n  protected readonly network: NetworkType;\n  public mirrorNode: HederaMirrorNode;\n  protected readonly logger: ILogger;\n\n  constructor(params: {\n    network: NetworkType;\n    logger?: ILogger;\n    mirrorNodeUrl?: string;\n  }) {\n    this.network = params.network;\n    this.logger =\n      params.logger || new Logger({ level: 'info', module: 'HCS-16' });\n    this.mirrorNode = new HederaMirrorNode(this.network, this.logger, {\n      customUrl: params.mirrorNodeUrl,\n    });\n  }\n\n  async assembleKeyList(params: {\n    members: string[];\n    threshold: number;\n  }): Promise<KeyList> {\n    const keys: PublicKey[] = [];\n    for (const accountId of params.members) {\n      const pub = await this.mirrorNode.getPublicKey(accountId);\n      keys.push(pub);\n    }\n    return new KeyList(keys, params.threshold);\n  }\n\n  async assembleSubmitKeyList(members: string[]): Promise<KeyList> {\n    const keys: PublicKey[] = [];\n    for (const accountId of members) {\n      const pub = await this.mirrorNode.getPublicKey(accountId);\n      keys.push(pub);\n    }\n    return new KeyList(keys, 1);\n  }\n\n  buildFloraTopicCreateTxs(params: {\n    floraAccountId: string;\n    keyList: KeyList;\n    submitList: KeyList;\n    autoRenewAccountId?: string;\n  }): {\n    communication: TopicCreateTransaction;\n    transaction: TopicCreateTransaction;\n    state: TopicCreateTransaction;\n  } {\n    const communication = buildHcs16CreateFloraTopicTx({\n      floraAccountId: params.floraAccountId,\n      topicType: FloraTopicType.COMMUNICATION,\n      adminKey: params.keyList,\n      submitKey: params.submitList,\n      autoRenewAccountId: params.autoRenewAccountId,\n    });\n    const transaction = buildHcs16CreateFloraTopicTx({\n      floraAccountId: params.floraAccountId,\n      topicType: FloraTopicType.TRANSACTION,\n      adminKey: params.keyList,\n      submitKey: params.submitList,\n      autoRenewAccountId: params.autoRenewAccountId,\n    });\n    const state = buildHcs16CreateFloraTopicTx({\n      floraAccountId: params.floraAccountId,\n      topicType: FloraTopicType.STATE,\n      adminKey: params.keyList,\n      submitKey: params.submitList,\n      autoRenewAccountId: params.autoRenewAccountId,\n    });\n    return { communication, transaction, state };\n  }\n\n  /**\n   * Parse an HCS‑16 Flora topic memo of the form `hcs-16:<floraAccountId>:<topicType>`.\n   */\n  parseTopicMemo(memo: string): {\n    protocol: 'hcs-16';\n    floraAccountId: string;\n    topicType: FloraTopicType;\n  } | null {\n    const match = memo.match(/^hcs-16:([0-9.]+):(\\d)$/);\n    if (!match) {\n      return null;\n    }\n    const floraAccountId = match[1];\n    const topicType = Number(match[2]) as FloraTopicType;\n    if (\n      topicType !== FloraTopicType.COMMUNICATION &&\n      topicType !== FloraTopicType.TRANSACTION &&\n      topicType !== FloraTopicType.STATE\n    ) {\n      return null;\n    }\n    return {\n      protocol: 'hcs-16',\n      floraAccountId,\n      topicType,\n    };\n  }\n\n  /**\n   * Build a Flora message envelope by merging an operation body into the HCS‑16 envelope.\n   */\n  protected createFloraMessage(\n    op: FloraOperation,\n    operatorId: string,\n    body?: Record<string, unknown>,\n  ): FloraMessage {\n    const payload: FloraMessage = {\n      p: 'hcs-16',\n      op,\n      operator_id: operatorId,\n      ...(body || {}),\n    } as FloraMessage;\n    return payload;\n  }\n\n  /**\n   * Fetch recent HCS‑16 messages from a topic via Mirror Node.\n   */\n  async getRecentMessages(\n    topicId: string,\n    options?: {\n      limit?: number;\n      order?: 'asc' | 'desc';\n      opFilter?: FloraOperation | string;\n    },\n  ): Promise<\n    Array<{\n      message: FloraMessage;\n      consensus_timestamp?: string;\n      sequence_number: number;\n      payer?: string;\n    }>\n  > {\n    const limit = options?.limit ?? 25;\n    const order = options?.order ?? 'desc';\n    const items: HCSMessageWithCommonFields[] =\n      await this.mirrorNode.getTopicMessages(topicId, { limit, order });\n\n    const results: Array<{\n      message: FloraMessage;\n      consensus_timestamp?: string;\n      sequence_number: number;\n      payer?: string;\n    }> = [];\n\n    for (const raw of items) {\n      if (raw.p !== 'hcs-16') {\n        continue;\n      }\n\n      const {\n        consensus_timestamp,\n        sequence_number,\n        running_hash,\n        running_hash_version,\n        topic_id,\n        payer,\n        created,\n        chunk_info,\n        ...payload\n      } = raw as unknown as Record<string, unknown>;\n\n      const op = payload.op as FloraOperation | string | undefined;\n      const operatorId = payload.operator_id as string | undefined;\n\n      if (options?.opFilter && op !== options.opFilter) {\n        continue;\n      }\n      if (typeof operatorId !== 'string') {\n        continue;\n      }\n\n      const message = payload as unknown as FloraMessage;\n\n      results.push({\n        message,\n        consensus_timestamp: consensus_timestamp as string | undefined,\n        sequence_number: Number(sequence_number),\n        payer: payer as string | undefined,\n      });\n    }\n    return results;\n  }\n\n  /**\n   * Return the latest valid HCS‑16 message on a topic, if any.\n   */\n  async getLatestMessage(\n    topicId: string,\n    opFilter?: FloraOperation | string,\n  ): Promise<\n    | (FloraMessage & { consensus_timestamp?: string; sequence_number: number })\n    | null\n  > {\n    const items = await this.getRecentMessages(topicId, {\n      limit: 1,\n      order: 'desc',\n      opFilter,\n    });\n    if (items.length === 0) {\n      return null;\n    }\n    const first = items[0];\n    return Object.assign({}, first.message, {\n      consensus_timestamp: first.consensus_timestamp,\n      sequence_number: first.sequence_number,\n    });\n  }\n}\n"],"names":[],"mappings":"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"}

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

@@ -1,116 +1,52 @@
-import { Client } from "@hashgraph/sdk";
-import { Logger } from "./standards-sdk.es111.js";
-import { createNodeOperatorContext } from "./standards-sdk.es146.js";
-import { buildHcs18CreateDiscoveryTopicTx, buildHcs18AnnounceMessage, buildHcs18SubmitDiscoveryMessageTx, buildHcs18ProposeMessage, buildHcs18RespondMessage, buildHcs18CompleteMessage, buildHcs18WithdrawMessage } from "./standards-sdk.es103.js";
-import { HCS18BaseClient } from "./standards-sdk.es104.js";
-class HCS18Client extends HCS18BaseClient {
-  constructor(config) {
-    super({
-      network: config.network,
-      logger: Logger.getInstance({
-        level: config.logLevel || "info",
-        module: "HCS-18",
-        silent: config.silent
-      })
-    });
-    this.operatorCtx = createNodeOperatorContext({
-      network: this.network,
-      operatorId: config.operatorId,
-      operatorKey: config.operatorKey,
-      mirrorNode: this.mirrorNode,
-      logger: this.logger,
-      client: Client.forName(this.network)
-    });
-    this.client = this.operatorCtx.client;
+import { z } from "zod";
+const hcs17MessageSchema = z.object({
+  p: z.literal("hcs-17"),
+  op: z.literal("state_hash"),
+  state_hash: z.string().min(1),
+  topics: z.array(z.string()),
+  account_id: z.string().min(1),
+  epoch: z.number().int().nonnegative().optional(),
+  timestamp: z.string().optional(),
+  m: z.string().optional()
+});
+class StateHashError extends Error {
+  constructor(message, code) {
+    super(message);
+    this.code = code;
+    this.name = "StateHashError";
   }
-  async ensureInitialized() {
-    await this.operatorCtx.ensureInitialized();
-  }
-  async createDiscoveryTopic(options) {
-    await this.ensureInitialized();
-    const ttl = options?.ttlSeconds;
-    let operatorPublicKey;
-    try {
-      operatorPublicKey = this.operatorCtx.operatorKey.publicKey;
-    } catch {
-      operatorPublicKey = void 0;
+}
+var HCS17TopicType = /* @__PURE__ */ ((HCS17TopicType2) => {
+  HCS17TopicType2[HCS17TopicType2["STATE"] = 0] = "STATE";
+  return HCS17TopicType2;
+})(HCS17TopicType || {});
+function generateHCS17Memo(ttl) {
+  return `hcs-17:${0}:${ttl}`;
+}
+function parseHCS17Memo(memo) {
+  try {
+    const match = memo.match(/^hcs-17:(\d+):(\d+)$/);
+    if (!match) {
+      return void 0;
     }
-    const tx = buildHcs18CreateDiscoveryTopicTx({
-      ttlSeconds: ttl,
-      adminKey: options?.adminKey,
-      submitKey: options?.submitKey,
-      operatorPublicKey,
-      memoOverride: options?.memoOverride
-    });
-    const resp = await tx.execute(this.client);
-    const receipt = await resp.getReceipt(this.client);
-    const topicId = receipt.topicId?.toString();
-    if (!topicId) {
-      throw new Error("Failed to create discovery topic");
+    const type = Number(match[1]);
+    const ttl = Number(match[2]);
+    if (Number.isNaN(type) || Number.isNaN(ttl) || ttl <= 0) {
+      return void 0;
     }
-    return { topicId, receipt };
-  }
-  async announce(params) {
-    await this.ensureInitialized();
-    const message = buildHcs18AnnounceMessage(params.data);
-    const tx = buildHcs18SubmitDiscoveryMessageTx({
-      topicId: params.discoveryTopicId,
-      message,
-      transactionMemo: params.memo
-    });
-    const resp = await tx.execute(this.client);
-    const receipt = await resp.getReceipt(this.client);
-    const seq = receipt.topicSequenceNumber.toNumber();
-    return { receipt, sequenceNumber: seq };
-  }
-  async propose(params) {
-    await this.ensureInitialized();
-    const message = buildHcs18ProposeMessage(params.data);
-    const tx = buildHcs18SubmitDiscoveryMessageTx({
-      topicId: params.discoveryTopicId,
-      message,
-      transactionMemo: params.memo
-    });
-    const resp = await tx.execute(this.client);
-    const receipt = await resp.getReceipt(this.client);
-    const seq = receipt.topicSequenceNumber.toNumber();
-    return { receipt, sequenceNumber: seq };
-  }
-  async respond(params) {
-    await this.ensureInitialized();
-    const message = buildHcs18RespondMessage(params.data);
-    const tx = buildHcs18SubmitDiscoveryMessageTx({
-      topicId: params.discoveryTopicId,
-      message,
-      transactionMemo: params.memo
-    });
-    const resp = await tx.execute(this.client);
-    return await resp.getReceipt(this.client);
-  }
-  async complete(params) {
-    await this.ensureInitialized();
-    const message = buildHcs18CompleteMessage(params.data);
-    const tx = buildHcs18SubmitDiscoveryMessageTx({
-      topicId: params.discoveryTopicId,
-      message,
-      transactionMemo: params.memo
-    });
-    const resp = await tx.execute(this.client);
-    return await resp.getReceipt(this.client);
-  }
-  async withdraw(params) {
-    await this.ensureInitialized();
-    const message = buildHcs18WithdrawMessage(params.data);
-    const tx = buildHcs18SubmitDiscoveryMessageTx({
-      topicId: params.discoveryTopicId,
-      message,
-      transactionMemo: params.memo
-    });
-    const resp = await tx.execute(this.client);
-    return await resp.getReceipt(this.client);
+    if (type !== 0) {
+      return void 0;
+    }
+    return { type, ttl };
+  } catch {
+    return void 0;
   }
 }
 export {
-  HCS18Client
+  HCS17TopicType,
+  StateHashError,
+  generateHCS17Memo,
+  hcs17MessageSchema,
+  parseHCS17Memo
 };
 //# sourceMappingURL=standards-sdk.es101.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"standards-sdk.es101.js","sources":["../../src/hcs-18/sdk.ts"],"sourcesContent":["import {\n  Client,\n  TopicCreateTransaction,\n  TransactionReceipt,\n} from '@hashgraph/sdk';\nimport { Logger } from '../utils/logger';\nimport { NetworkType } from '../utils/types';\nimport {\n  createNodeOperatorContext,\n  type NodeOperatorContext,\n} from '../common/node-operator-resolver';\nimport type { MaybeKey } from '../common/tx/tx-utils';\nimport { buildHcs18CreateDiscoveryTopicTx } from './tx';\nimport { HCS18BaseClient } from './base-client';\nimport type {\n  AnnounceData,\n  ProposeData,\n  RespondData,\n  CompleteMessage,\n  WithdrawMessage,\n  DiscoveryMessage,\n} from './types';\nimport {\n  buildHcs18SubmitDiscoveryMessageTx,\n  buildHcs18AnnounceMessage,\n  buildHcs18ProposeMessage,\n  buildHcs18RespondMessage,\n  buildHcs18CompleteMessage,\n  buildHcs18WithdrawMessage,\n} from './tx';\n\nexport interface SDKHCS18ClientConfig {\n  network: NetworkType;\n  operatorId: string;\n  operatorKey: string | import('@hashgraph/sdk').PrivateKey;\n  logLevel?: 'debug' | 'info' | 'warn' | 'error' | 'silent';\n  silent?: boolean;\n}\n\nexport class HCS18Client extends HCS18BaseClient {\n  private readonly operatorCtx: NodeOperatorContext;\n  private readonly client: Client;\n\n  constructor(config: SDKHCS18ClientConfig) {\n    super({\n      network: config.network,\n      logger: Logger.getInstance({\n        level: config.logLevel || 'info',\n        module: 'HCS-18',\n        silent: config.silent,\n      }),\n    });\n    this.operatorCtx = createNodeOperatorContext({\n      network: this.network,\n      operatorId: config.operatorId,\n      operatorKey: config.operatorKey,\n      mirrorNode: this.mirrorNode,\n      logger: this.logger,\n      client: Client.forName(this.network),\n    });\n    this.client = this.operatorCtx.client;\n  }\n\n  private async ensureInitialized(): Promise<void> {\n    await this.operatorCtx.ensureInitialized();\n  }\n\n  async createDiscoveryTopic(options?: {\n    ttlSeconds?: number;\n    adminKey?: MaybeKey;\n    submitKey?: MaybeKey;\n    memoOverride?: string;\n  }): Promise<{ topicId: string; receipt: TransactionReceipt }> {\n    await this.ensureInitialized();\n    const ttl = options?.ttlSeconds;\n\n    let operatorPublicKey: import('@hashgraph/sdk').PublicKey | undefined;\n    try {\n      operatorPublicKey = this.operatorCtx.operatorKey.publicKey;\n    } catch {\n      operatorPublicKey = undefined;\n    }\n    const tx: TopicCreateTransaction = buildHcs18CreateDiscoveryTopicTx({\n      ttlSeconds: ttl,\n      adminKey: options?.adminKey,\n      submitKey: options?.submitKey,\n      operatorPublicKey,\n      memoOverride: options?.memoOverride,\n    });\n    const resp = await tx.execute(this.client);\n    const receipt = await resp.getReceipt(this.client);\n    const topicId = receipt.topicId?.toString();\n    if (!topicId) {\n      throw new Error('Failed to create discovery topic');\n    }\n    return { topicId, receipt };\n  }\n\n  async announce(params: {\n    discoveryTopicId: string;\n    data: AnnounceData;\n    memo?: string;\n  }): Promise<{ receipt: TransactionReceipt; sequenceNumber: number }> {\n    await this.ensureInitialized();\n    const message: DiscoveryMessage = buildHcs18AnnounceMessage(params.data);\n    const tx = buildHcs18SubmitDiscoveryMessageTx({\n      topicId: params.discoveryTopicId,\n      message,\n      transactionMemo: params.memo,\n    });\n    const resp = await tx.execute(this.client);\n    const receipt = await resp.getReceipt(this.client);\n    const seq = receipt.topicSequenceNumber.toNumber();\n    return { receipt, sequenceNumber: seq };\n  }\n\n  async propose(params: {\n    discoveryTopicId: string;\n    data: ProposeData;\n    memo?: string;\n  }): Promise<{ receipt: TransactionReceipt; sequenceNumber: number }> {\n    await this.ensureInitialized();\n    const message: DiscoveryMessage = buildHcs18ProposeMessage(params.data);\n    const tx = buildHcs18SubmitDiscoveryMessageTx({\n      topicId: params.discoveryTopicId,\n      message,\n      transactionMemo: params.memo,\n    });\n    const resp = await tx.execute(this.client);\n    const receipt = await resp.getReceipt(this.client);\n    const seq = receipt.topicSequenceNumber.toNumber();\n    return { receipt, sequenceNumber: seq };\n  }\n\n  async respond(params: {\n    discoveryTopicId: string;\n    data: RespondData;\n    memo?: string;\n  }): Promise<TransactionReceipt> {\n    await this.ensureInitialized();\n    const message: DiscoveryMessage = buildHcs18RespondMessage(params.data);\n    const tx = buildHcs18SubmitDiscoveryMessageTx({\n      topicId: params.discoveryTopicId,\n      message,\n      transactionMemo: params.memo,\n    });\n    const resp = await tx.execute(this.client);\n    return await resp.getReceipt(this.client);\n  }\n\n  async complete(params: {\n    discoveryTopicId: string;\n    data: CompleteMessage['data'];\n    memo?: string;\n  }): Promise<TransactionReceipt> {\n    await this.ensureInitialized();\n    const message: DiscoveryMessage = buildHcs18CompleteMessage(params.data);\n    const tx = buildHcs18SubmitDiscoveryMessageTx({\n      topicId: params.discoveryTopicId,\n      message,\n      transactionMemo: params.memo,\n    });\n    const resp = await tx.execute(this.client);\n    return await resp.getReceipt(this.client);\n  }\n\n  async withdraw(params: {\n    discoveryTopicId: string;\n    data: WithdrawMessage['data'];\n    memo?: string;\n  }): Promise<TransactionReceipt> {\n    await this.ensureInitialized();\n    const message: DiscoveryMessage = buildHcs18WithdrawMessage(params.data);\n    const tx = buildHcs18SubmitDiscoveryMessageTx({\n      topicId: params.discoveryTopicId,\n      message,\n      transactionMemo: params.memo,\n    });\n    const resp = await tx.execute(this.client);\n    return await resp.getReceipt(this.client);\n  }\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"standards-sdk.es101.js","sources":["../../src/hcs-17/types.ts"],"sourcesContent":["import { PublicKey, PrivateKey } from '@hashgraph/sdk';\nimport type { HashinalsWalletConnectSDK } from '@hashgraphonline/hashinal-wc';\nimport type { DAppSigner } from '@hashgraph/hedera-wallet-connect';\nimport { z } from 'zod';\nimport { Logger, LogLevel } from '../utils/logger';\nimport { NetworkType } from '../utils/types';\n\n/**\n * HCS-17 Topic state information\n */\nexport interface TopicState {\n  topicId: string;\n  latestRunningHash: string;\n}\n\n/**\n * HCS-17 Account state hash input\n */\nexport interface AccountStateInput {\n  accountId: string;\n  publicKey: PublicKey | string;\n  topics: TopicState[];\n}\n\n/**\n * HCS-17 Composite state hash input for Flora/Bloom\n */\nexport interface CompositeStateInput {\n  compositeAccountId: string;\n  compositePublicKeyFingerprint: string;\n  memberStates: Array<{\n    accountId: string;\n    stateHash: string;\n  }>;\n  compositeTopics: TopicState[];\n}\n\n/**\n * HCS-17 State hash message format\n */\nexport interface StateHashMessage {\n  p: 'hcs-17';\n  op: 'state_hash';\n  state_hash: string;\n  topics: string[];\n  account_id: string;\n  epoch?: number;\n  timestamp?: string;\n  m?: string;\n}\n\nexport const hcs17MessageSchema = z.object({\n  p: z.literal('hcs-17'),\n  op: z.literal('state_hash'),\n  state_hash: z.string().min(1),\n  topics: z.array(z.string()),\n  account_id: z.string().min(1),\n  epoch: z.number().int().nonnegative().optional(),\n  timestamp: z.string().optional(),\n  m: z.string().optional(),\n});\n\n/**\n * HCS-17 State hash result\n */\nexport interface StateHashResult {\n  stateHash: string;\n  accountId: string;\n  timestamp: Date;\n  topicCount: number;\n}\n\n/**\n * HCS-17 Composite state hash result\n */\nexport interface CompositeStateHashResult extends StateHashResult {\n  memberCount: number;\n  compositeTopicCount: number;\n}\n\n/**\n * HCS-17 errors\n */\nexport class StateHashError extends Error {\n  constructor(\n    message: string,\n    public readonly code: string,\n  ) {\n    super(message);\n    this.name = 'StateHashError';\n  }\n}\n\n/**\n * Base configuration shared by HCS‑17 Node and Browser clients.\n */\nexport interface HCS17ClientConfig {\n  network: NetworkType;\n  logLevel?: LogLevel;\n  silent?: boolean;\n  mirrorNodeUrl?: string;\n  logger?: Logger;\n}\n\n/**\n * Node SDK configuration for HCS‑17 client.\n */\nexport interface SDKHCS17ClientConfig extends HCS17ClientConfig {\n  operatorId: string;\n  operatorKey: string | PrivateKey;\n  keyType?: 'ed25519' | 'ecdsa';\n}\n\n/**\n * Browser client configuration for HCS‑17 operations.\n */\nexport interface BrowserHCS17ClientConfig extends HCS17ClientConfig {\n  hwc?: HashinalsWalletConnectSDK;\n  signer?: DAppSigner;\n}\n\n/**\n * HCS‑17 topic types (numeric codes for memo encoding).\n */\nexport enum HCS17TopicType {\n  STATE = 0,\n}\n\n/**\n * Generate the standard HCS‑17 topic memo: `hcs-17:<type>:<ttl>`.\n */\nexport function generateHCS17Memo(ttl: number): string {\n  return `hcs-17:${HCS17TopicType.STATE}:${ttl}`;\n}\n\n/**\n * Parse an HCS‑17 memo into `{ type, ttl }` if valid.\n */\nexport function parseHCS17Memo(\n  memo: string,\n): { type: HCS17TopicType; ttl: number } | undefined {\n  try {\n    const match = memo.match(/^hcs-17:(\\d+):(\\d+)$/);\n    if (!match) {\n      return undefined;\n    }\n    const type = Number(match[1]) as HCS17TopicType;\n    const ttl = Number(match[2]);\n    if (Number.isNaN(type) || Number.isNaN(ttl) || ttl <= 0) {\n      return undefined;\n    }\n    if (type !== HCS17TopicType.STATE) {\n      return undefined;\n    }\n    return { type, ttl };\n  } catch {\n    return undefined;\n  }\n}\n"],"names":["HCS17TopicType"],"mappings":";AAmDO,MAAM,qBAAqB,EAAE,OAAO;AAAA,EACzC,GAAG,EAAE,QAAQ,QAAQ;AAAA,EACrB,IAAI,EAAE,QAAQ,YAAY;AAAA,EAC1B,YAAY,EAAE,SAAS,IAAI,CAAC;AAAA,EAC5B,QAAQ,EAAE,MAAM,EAAE,QAAQ;AAAA,EAC1B,YAAY,EAAE,SAAS,IAAI,CAAC;AAAA,EAC5B,OAAO,EAAE,OAAA,EAAS,MAAM,YAAA,EAAc,SAAA;AAAA,EACtC,WAAW,EAAE,OAAA,EAAS,SAAA;AAAA,EACtB,GAAG,EAAE,OAAA,EAAS,SAAA;AAChB,CAAC;AAuBM,MAAM,uBAAuB,MAAM;AAAA,EACxC,YACE,SACgB,MAChB;AACA,UAAM,OAAO;AAFG,SAAA,OAAA;AAGhB,SAAK,OAAO;AAAA,EACd;AACF;AAiCO,IAAK,mCAAAA,oBAAL;AACLA,kBAAAA,gBAAA,WAAQ,CAAA,IAAR;AADU,SAAAA;AAAA,GAAA,kBAAA,CAAA,CAAA;AAOL,SAAS,kBAAkB,KAAqB;AACrD,SAAO,UAAU,KAAwB,GAAG;AAC9C;AAKO,SAAS,eACd,MACmD;AACnD,MAAI;AACF,UAAM,QAAQ,KAAK,MAAM,sBAAsB;AAC/C,QAAI,CAAC,OAAO;AACV,aAAO;AAAA,IACT;AACA,UAAM,OAAO,OAAO,MAAM,CAAC,CAAC;AAC5B,UAAM,MAAM,OAAO,MAAM,CAAC,CAAC;AAC3B,QAAI,OAAO,MAAM,IAAI,KAAK,OAAO,MAAM,GAAG,KAAK,OAAO,GAAG;AACvD,aAAO;AAAA,IACT;AACA,QAAI,SAAS,GAAsB;AACjC,aAAO;AAAA,IACT;AACA,WAAO,EAAE,MAAM,IAAA;AAAA,EACjB,QAAQ;AACN,WAAO;AAAA,EACT;AACF;"}