@hashgraphonline/standards-sdk 0.1.184 → 0.1.185

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

@@ -1,108 +1,239 @@
-import { z } from "zod";
-import { hcs26TopicTypeEnumSchema, HCS26_PROTOCOL, hcs26OperationEnumSchema } from "./standards-sdk.es117.js";
-const HCS26_DEFAULT_TTL_SECONDS = 86400;
-function toPositiveInt(value) {
-  if (!Number.isFinite(value)) {
-    throw new Error("Expected a finite number");
-  }
-  const intValue = Math.floor(value);
-  if (intValue <= 0) {
-    throw new Error("Expected a positive integer");
-  }
-  return intValue;
+import { isValidAdapterId, isValidComponentKey, isValidComponentName } from "./standards-sdk.es117.js";
+import { HCS25_DEFAULT_STALE_MULTIPLIER, HCS25_DEFAULT_ROUNDING_DECIMALS, hcs25SubjectSchema, hcs25SignalSnapshotSchema, HCS25_DEFAULT_WEIGHT, HCS25_DEFAULT_CONTRIBUTION_MODE } from "./standards-sdk.es118.js";
+function clampScore(value) {
+  return Math.min(100, Math.max(0, value));
 }
-function buildHcs26TopicMemo(input) {
-  const indexed = input.indexed ?? true;
-  const ttlSeconds = toPositiveInt(
-    input.ttlSeconds ?? HCS26_DEFAULT_TTL_SECONDS
-  );
-  const topicType = hcs26TopicTypeEnumSchema.parse(input.topicType);
-  const indexedSegment = indexed ? "0" : "1";
-  return `${HCS26_PROTOCOL}:${indexedSegment}:${ttlSeconds}:${topicType}`;
+function roundScore(value, decimals = 2) {
+  const factor = 10 ** decimals;
+  return Math.round(value * factor) / factor;
 }
-function parseHcs26TopicMemo(memoRaw) {
-  const memo = memoRaw.trim();
-  if (!memo) {
-    return null;
+function compileScoringConfig(input) {
+  if (!Number.isInteger(input.version) || input.version < 0) {
+    throw new TypeError(
+      "trustScoreConfigVersion must be a non-negative integer"
+    );
   }
-  const match = memo.match(/^hcs-26:(\d+):(\d+):(\d+)$/);
-  if (!match) {
-    return null;
+  if (!Array.isArray(input.adapters) || input.adapters.length === 0) {
+    throw new TypeError("at least one trust adapter is required");
   }
-  const indexedSegment = Number(match[1]);
-  const ttlSeconds = Number(match[2]);
-  const topicType = Number(match[3]);
-  if (![indexedSegment, ttlSeconds, topicType].every(Number.isFinite)) {
-    return null;
+  const seenAdapterIds = /* @__PURE__ */ new Set();
+  for (const adapter of input.adapters) {
+    validateAdapter(adapter, seenAdapterIds);
+    seenAdapterIds.add(adapter.id);
   }
-  const parsedTopicType = hcs26TopicTypeEnumSchema.safeParse(topicType);
-  if (!parsedTopicType.success) {
-    return null;
+  const staleMultiplier = input.staleMultiplier ?? HCS25_DEFAULT_STALE_MULTIPLIER;
+  if (!Number.isFinite(staleMultiplier) || staleMultiplier < 0 || staleMultiplier > 1) {
+    throw new TypeError("staleMultiplier must be a number in [0, 1]");
   }
-  if (indexedSegment !== 0 && indexedSegment !== 1) {
-    return null;
+  const roundingDecimals = input.roundingDecimals ?? HCS25_DEFAULT_ROUNDING_DECIMALS;
+  if (!Number.isInteger(roundingDecimals) || roundingDecimals < 0 || roundingDecimals > 6) {
+    throw new TypeError("roundingDecimals must be an integer in [0, 6]");
   }
   return {
-    protocol: HCS26_PROTOCOL,
-    indexed: indexedSegment === 0,
-    ttlSeconds,
-    topicType: parsedTopicType.data
+    version: input.version,
+    adapters: input.adapters,
+    staleMultiplier,
+    roundingDecimals,
+    computeConfidence: input.computeConfidence ?? false
   };
 }
-function buildHcs26TransactionMemo(input) {
-  const operation = hcs26OperationEnumSchema.parse(input.operation);
-  const topicType = hcs26TopicTypeEnumSchema.parse(input.topicType);
-  return `${HCS26_PROTOCOL}:op:${operation}:${topicType}`;
+function validateAdapter(adapter, seenAdapterIds) {
+  if (typeof adapter.id !== "string" || !isValidAdapterId(adapter.id)) {
+    throw new TypeError(
+      `invalid adapterId "${String(adapter.id)}": adapter identifiers must match ^[a-z][a-z0-9]*(-[a-z][a-z0-9]*)*$`
+    );
+  }
+  if (seenAdapterIds.has(adapter.id)) {
+    throw new TypeError(
+      `duplicate adapterId "${adapter.id}": adapter identifiers must be unique within a configuration`
+    );
+  }
+  if (adapter.weight !== void 0 && (!Number.isFinite(adapter.weight) || adapter.weight < 0)) {
+    throw new TypeError(
+      `adapter "${adapter.id}" weight must be a finite non-negative number`
+    );
+  }
+  if (!Array.isArray(adapter.components) || adapter.components.length === 0) {
+    throw new TypeError(
+      `adapter "${adapter.id}" must declare at least one component`
+    );
+  }
+  if (adapter.defaultComponentKey !== void 0 && !isValidComponentKey(adapter.defaultComponentKey)) {
+    throw new TypeError(
+      `adapter "${adapter.id}" defaultComponentKey must be a valid component key`
+    );
+  }
+  for (const component of adapter.components) {
+    if (typeof component.name !== "string" || !isValidComponentName(component.name)) {
+      throw new TypeError(
+        `adapter "${adapter.id}" component name "${String(component.name)}" is not a valid component key segment`
+      );
+    }
+    if (component.weight !== void 0 && (!Number.isFinite(component.weight) || component.weight < 0)) {
+      throw new TypeError(
+        `adapter "${adapter.id}" component "${component.name}" weight must be a finite non-negative number`
+      );
+    }
+    if (typeof component.normalize !== "function") {
+      throw new TypeError(
+        `adapter "${adapter.id}" component "${component.name}" must declare a normalize function`
+      );
+    }
+  }
 }
-function parseHcs26TransactionMemo(memoRaw) {
-  const memo = memoRaw.trim();
-  if (!memo) {
-    return null;
+function isAdapterApplicable(adapter, subject) {
+  if (adapter.includeRegistries) {
+    if (subject.registry === void 0 || !adapter.includeRegistries.includes(subject.registry)) {
+      return false;
+    }
   }
-  const match = memo.match(/^hcs-26:op:(\d+):(\d+)$/);
-  if (!match) {
-    return null;
+  if (adapter.excludeRegistries && subject.registry !== void 0 && adapter.excludeRegistries.includes(subject.registry)) {
+    return false;
   }
-  const operation = Number(match[1]);
-  const topicType = Number(match[2]);
-  if (![operation, topicType].every(Number.isFinite)) {
-    return null;
+  if (adapter.appliesTo && !adapter.appliesTo(subject)) {
+    return false;
   }
-  const parsedOperation = hcs26OperationEnumSchema.safeParse(operation);
-  if (!parsedOperation.success) {
-    return null;
+  return true;
+}
+function computeTrustScore(input) {
+  const config = compileScoringConfig(input.config);
+  const subject = hcs25SubjectSchema.parse(input.subject);
+  const snapshot = hcs25SignalSnapshotSchema.parse(input.snapshot);
+  const context = { subject, snapshot, config };
+  const adapterScores = [];
+  const trustScores = {};
+  for (const adapter of config.adapters) {
+    const adapterScore = scoreAdapter(adapter, subject, context, config);
+    adapterScores.push(adapterScore);
+    if (adapterScore.applicable) {
+      for (const component of adapterScore.components) {
+        trustScores[component.key] = component.value;
+      }
+    }
   }
-  const parsedTopicType = hcs26TopicTypeEnumSchema.safeParse(topicType);
-  if (!parsedTopicType.success) {
-    return null;
+  const denominator = adapterScores.filter((score) => score.inDenominator);
+  const totalWeight = denominator.reduce((sum, score) => sum + score.weight, 0);
+  const weightedSum = denominator.reduce(
+    (sum, score) => sum + score.total * score.weight,
+    0
+  );
+  const total = totalWeight > 0 ? roundScore(weightedSum / totalWeight, config.roundingDecimals) : 0;
+  trustScores.total = total;
+  const record = {
+    trustScore: total,
+    trustScores,
+    trustScoreConfigVersion: config.version,
+    trustScoreUpdatedAt: (input.now ?? /* @__PURE__ */ new Date()).toISOString(),
+    breakdown: { adapters: adapterScores }
+  };
+  if (config.computeConfidence) {
+    record.trustConfidence = computeConfidence(denominator, totalWeight);
+  }
+  return record;
+}
+function scoreAdapter(adapter, subject, context, config) {
+  const weight = adapter.weight ?? HCS25_DEFAULT_WEIGHT;
+  const contributionMode = adapter.contributionMode ?? HCS25_DEFAULT_CONTRIBUTION_MODE;
+  const applicable = isAdapterApplicable(adapter, subject);
+  const components = [];
+  const unavailable = [];
+  if (applicable) {
+    for (const component of adapter.components) {
+      const key = `${adapter.id}.${component.name}`;
+      const normalized = normalizeComponent(component.normalize(context));
+      if (normalized === null) {
+        if (component.nonScorableWhenUnavailable) {
+          unavailable.push(key);
+        } else {
+          components.push({
+            key,
+            value: 0,
+            status: "missing",
+            weight: resolveWeight(component.weight)
+          });
+        }
+        continue;
+      }
+      const value = normalized.status === "stale" ? clampScore(normalized.value * config.staleMultiplier) : clampScore(normalized.value);
+      components.push({
+        key,
+        value,
+        status: normalized.status,
+        weight: resolveWeight(component.weight)
+      });
+    }
+    if (components.length === 0 && contributionMode !== HCS25_DEFAULT_CONTRIBUTION_MODE) {
+      const defaultKey = adapter.defaultComponentKey ?? `${adapter.id}.score`;
+      components.push({
+        key: defaultKey,
+        value: 0,
+        status: "missing",
+        weight: HCS25_DEFAULT_WEIGHT
+      });
+    }
+  }
+  let inDenominator = false;
+  if (applicable) {
+    inDenominator = contributionMode === "conditional" ? components.length > 0 : true;
+    if (weight === 0) {
+      inDenominator = false;
+    }
   }
   return {
-    protocol: HCS26_PROTOCOL,
-    operation: parsedOperation.data,
-    topicType: parsedTopicType.data
+    adapterId: adapter.id,
+    contributionMode,
+    applicable,
+    inDenominator,
+    weight,
+    components,
+    unavailable,
+    total: adapterTotal(components, config.roundingDecimals)
   };
 }
-const hcs26TopicMemoSchema = z.string().transform((value) => {
-  const parsed = parseHcs26TopicMemo(value);
-  if (!parsed) {
-    throw new Error("Invalid HCS-26 topic memo");
-  }
-  return parsed;
-});
-const hcs26TransactionMemoSchema = z.string().transform((value) => {
-  const parsed = parseHcs26TransactionMemo(value);
-  if (!parsed) {
-    throw new Error("Invalid HCS-26 transaction memo");
-  }
-  return parsed;
-});
+function normalizeComponent(normalized) {
+  if (!Number.isFinite(normalized.value)) {
+    return null;
+  }
+  if (normalized.status === "missing" || normalized.status === "timeout" || normalized.status === "error") {
+    return null;
+  }
+  return normalized;
+}
+function resolveWeight(weight) {
+  return weight ?? HCS25_DEFAULT_WEIGHT;
+}
+function adapterTotal(components, roundingDecimals) {
+  if (components.length === 0) {
+    return 0;
+  }
+  let weightedSum = 0;
+  let totalWeight = 0;
+  for (const component of components) {
+    weightedSum += component.value * component.weight;
+    totalWeight += component.weight;
+  }
+  const mean = totalWeight > 0 ? weightedSum / totalWeight : 0;
+  return roundScore(clampScore(mean), roundingDecimals);
+}
+function computeConfidence(denominator, totalWeight) {
+  if (totalWeight <= 0) {
+    return 0;
+  }
+  let weightedSum = 0;
+  for (const adapter of denominator) {
+    const okCount = adapter.components.filter(
+      (component) => component.status === "ok"
+    ).length;
+    const adapterConfidence = adapter.components.length > 0 ? okCount / adapter.components.length : 0;
+    weightedSum += adapter.weight * adapterConfidence;
+  }
+  return roundScore(weightedSum / totalWeight, 4);
+}
 export {
-  HCS26_DEFAULT_TTL_SECONDS,
-  buildHcs26TopicMemo,
-  buildHcs26TransactionMemo,
-  hcs26TopicMemoSchema,
-  hcs26TransactionMemoSchema,
-  parseHcs26TopicMemo,
-  parseHcs26TransactionMemo
+  clampScore,
+  compileScoringConfig,
+  computeTrustScore,
+  isAdapterApplicable,
+  roundScore
 };
 //# sourceMappingURL=standards-sdk.es119.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"standards-sdk.es119.js","sources":["../../src/hcs-26/memos.ts"],"sourcesContent":["import { z } from 'zod';\nimport {\n  HCS26_PROTOCOL,\n  hcs26OperationEnumSchema,\n  hcs26TopicTypeEnumSchema,\n  type Hcs26OperationEnum,\n  type Hcs26TopicTypeEnum,\n} from './types';\n\nexport type Hcs26TopicMemo = {\n  protocol: typeof HCS26_PROTOCOL;\n  indexed: boolean;\n  ttlSeconds: number;\n  topicType: Hcs26TopicTypeEnum;\n};\n\nexport const HCS26_DEFAULT_TTL_SECONDS = 86400;\n\nfunction toPositiveInt(value: number): number {\n  if (!Number.isFinite(value)) {\n    throw new Error('Expected a finite number');\n  }\n  const intValue = Math.floor(value);\n  if (intValue <= 0) {\n    throw new Error('Expected a positive integer');\n  }\n  return intValue;\n}\n\nexport function buildHcs26TopicMemo(input: {\n  indexed?: boolean;\n  ttlSeconds?: number;\n  topicType: Hcs26TopicTypeEnum;\n}): string {\n  const indexed = input.indexed ?? true;\n  const ttlSeconds = toPositiveInt(\n    input.ttlSeconds ?? HCS26_DEFAULT_TTL_SECONDS,\n  );\n  const topicType = hcs26TopicTypeEnumSchema.parse(input.topicType);\n\n  // HCS-2 memo convention: indexed topics use \"0\" in the second segment.\n  const indexedSegment = indexed ? '0' : '1';\n  return `${HCS26_PROTOCOL}:${indexedSegment}:${ttlSeconds}:${topicType}`;\n}\n\nexport function parseHcs26TopicMemo(memoRaw: string): Hcs26TopicMemo | null {\n  const memo = memoRaw.trim();\n  if (!memo) {\n    return null;\n  }\n\n  const match = memo.match(/^hcs-26:(\\d+):(\\d+):(\\d+)$/);\n  if (!match) {\n    return null;\n  }\n\n  const indexedSegment = Number(match[1]);\n  const ttlSeconds = Number(match[2]);\n  const topicType = Number(match[3]);\n\n  if (![indexedSegment, ttlSeconds, topicType].every(Number.isFinite)) {\n    return null;\n  }\n\n  const parsedTopicType = hcs26TopicTypeEnumSchema.safeParse(topicType);\n  if (!parsedTopicType.success) {\n    return null;\n  }\n\n  if (indexedSegment !== 0 && indexedSegment !== 1) {\n    return null;\n  }\n\n  return {\n    protocol: HCS26_PROTOCOL,\n    indexed: indexedSegment === 0,\n    ttlSeconds,\n    topicType: parsedTopicType.data,\n  };\n}\n\nexport function buildHcs26TransactionMemo(input: {\n  operation: Hcs26OperationEnum;\n  topicType: Hcs26TopicTypeEnum;\n}): string {\n  const operation = hcs26OperationEnumSchema.parse(input.operation);\n  const topicType = hcs26TopicTypeEnumSchema.parse(input.topicType);\n  return `${HCS26_PROTOCOL}:op:${operation}:${topicType}`;\n}\n\nexport type Hcs26TransactionMemo = {\n  protocol: typeof HCS26_PROTOCOL;\n  operation: Hcs26OperationEnum;\n  topicType: Hcs26TopicTypeEnum;\n};\n\nexport function parseHcs26TransactionMemo(\n  memoRaw: string,\n): Hcs26TransactionMemo | null {\n  const memo = memoRaw.trim();\n  if (!memo) {\n    return null;\n  }\n\n  const match = memo.match(/^hcs-26:op:(\\d+):(\\d+)$/);\n  if (!match) {\n    return null;\n  }\n\n  const operation = Number(match[1]);\n  const topicType = Number(match[2]);\n  if (![operation, topicType].every(Number.isFinite)) {\n    return null;\n  }\n\n  const parsedOperation = hcs26OperationEnumSchema.safeParse(operation);\n  if (!parsedOperation.success) {\n    return null;\n  }\n  const parsedTopicType = hcs26TopicTypeEnumSchema.safeParse(topicType);\n  if (!parsedTopicType.success) {\n    return null;\n  }\n\n  return {\n    protocol: HCS26_PROTOCOL,\n    operation: parsedOperation.data,\n    topicType: parsedTopicType.data,\n  };\n}\n\nexport const hcs26TopicMemoSchema = z.string().transform(value => {\n  const parsed = parseHcs26TopicMemo(value);\n  if (!parsed) {\n    throw new Error('Invalid HCS-26 topic memo');\n  }\n  return parsed;\n});\n\nexport const hcs26TransactionMemoSchema = z.string().transform(value => {\n  const parsed = parseHcs26TransactionMemo(value);\n  if (!parsed) {\n    throw new Error('Invalid HCS-26 transaction memo');\n  }\n  return parsed;\n});\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"standards-sdk.es119.js","sources":["../../src/hcs-25/scoring.ts"],"sourcesContent":["import {\n  isValidAdapterId,\n  isValidComponentKey,\n  isValidComponentName,\n} from './identifiers';\nimport {\n  HCS25_DEFAULT_CONTRIBUTION_MODE,\n  HCS25_DEFAULT_ROUNDING_DECIMALS,\n  HCS25_DEFAULT_STALE_MULTIPLIER,\n  HCS25_DEFAULT_WEIGHT,\n  hcs25SignalSnapshotSchema,\n  hcs25SubjectSchema,\n} from './types';\nimport type {\n  Hcs25AdapterDefinition,\n  Hcs25AdapterScore,\n  Hcs25ComponentResult,\n  Hcs25ContributionMode,\n  Hcs25NormalizedValue,\n  Hcs25ScoringConfig,\n  Hcs25ScoringConfigInput,\n  Hcs25SignalSnapshot,\n  Hcs25Subject,\n  Hcs25TrustScoreRecord,\n} from './types';\n\n/**\n * Clamps a finite component value into the HCS-25 range [0, 100].\n */\nexport function clampScore(value: number): number {\n  return Math.min(100, Math.max(0, value));\n}\n\n/**\n * Rounds a value to a stable decimal precision (default 2, per HCS-25).\n */\nexport function roundScore(value: number, decimals = 2): number {\n  const factor = 10 ** decimals;\n  return Math.round(value * factor) / factor;\n}\n\n/**\n * Validates an adapter set and resolves configuration defaults. The returned\n * configuration is safe to pass to {@link computeTrustScore}.\n */\nexport function compileScoringConfig(\n  input: Hcs25ScoringConfigInput,\n): Hcs25ScoringConfig {\n  if (!Number.isInteger(input.version) || input.version < 0) {\n    throw new TypeError(\n      'trustScoreConfigVersion must be a non-negative integer',\n    );\n  }\n\n  if (!Array.isArray(input.adapters) || input.adapters.length === 0) {\n    throw new TypeError('at least one trust adapter is required');\n  }\n\n  const seenAdapterIds = new Set<string>();\n  for (const adapter of input.adapters) {\n    validateAdapter(adapter, seenAdapterIds);\n    seenAdapterIds.add(adapter.id);\n  }\n\n  const staleMultiplier =\n    input.staleMultiplier ?? HCS25_DEFAULT_STALE_MULTIPLIER;\n  if (\n    !Number.isFinite(staleMultiplier) ||\n    staleMultiplier < 0 ||\n    staleMultiplier > 1\n  ) {\n    throw new TypeError('staleMultiplier must be a number in [0, 1]');\n  }\n\n  const roundingDecimals =\n    input.roundingDecimals ?? HCS25_DEFAULT_ROUNDING_DECIMALS;\n  if (\n    !Number.isInteger(roundingDecimals) ||\n    roundingDecimals < 0 ||\n    roundingDecimals > 6\n  ) {\n    throw new TypeError('roundingDecimals must be an integer in [0, 6]');\n  }\n\n  return {\n    version: input.version,\n    adapters: input.adapters,\n    staleMultiplier,\n    roundingDecimals,\n    computeConfidence: input.computeConfidence ?? false,\n  };\n}\n\nfunction validateAdapter(\n  adapter: Hcs25AdapterDefinition,\n  seenAdapterIds: Set<string>,\n): void {\n  if (typeof adapter.id !== 'string' || !isValidAdapterId(adapter.id)) {\n    throw new TypeError(\n      `invalid adapterId \"${String(adapter.id)}\": adapter identifiers must match ^[a-z][a-z0-9]*(-[a-z][a-z0-9]*)*$`,\n    );\n  }\n\n  if (seenAdapterIds.has(adapter.id)) {\n    throw new TypeError(\n      `duplicate adapterId \"${adapter.id}\": adapter identifiers must be unique within a configuration`,\n    );\n  }\n\n  if (\n    adapter.weight !== undefined &&\n    (!Number.isFinite(adapter.weight) || adapter.weight < 0)\n  ) {\n    throw new TypeError(\n      `adapter \"${adapter.id}\" weight must be a finite non-negative number`,\n    );\n  }\n\n  if (!Array.isArray(adapter.components) || adapter.components.length === 0) {\n    throw new TypeError(\n      `adapter \"${adapter.id}\" must declare at least one component`,\n    );\n  }\n\n  if (\n    adapter.defaultComponentKey !== undefined &&\n    !isValidComponentKey(adapter.defaultComponentKey)\n  ) {\n    throw new TypeError(\n      `adapter \"${adapter.id}\" defaultComponentKey must be a valid component key`,\n    );\n  }\n\n  for (const component of adapter.components) {\n    if (\n      typeof component.name !== 'string' ||\n      !isValidComponentName(component.name)\n    ) {\n      throw new TypeError(\n        `adapter \"${adapter.id}\" component name \"${String(component.name)}\" is not a valid component key segment`,\n      );\n    }\n\n    if (\n      component.weight !== undefined &&\n      (!Number.isFinite(component.weight) || component.weight < 0)\n    ) {\n      throw new TypeError(\n        `adapter \"${adapter.id}\" component \"${component.name}\" weight must be a finite non-negative number`,\n      );\n    }\n\n    if (typeof component.normalize !== 'function') {\n      throw new TypeError(\n        `adapter \"${adapter.id}\" component \"${component.name}\" must declare a normalize function`,\n      );\n    }\n  }\n}\n\n/**\n * Evaluates adapter applicability against a subject using registry\n * include/exclude lists and the optional appliesTo predicate.\n */\nexport function isAdapterApplicable(\n  adapter: Hcs25AdapterDefinition,\n  subject: Hcs25Subject,\n): boolean {\n  if (adapter.includeRegistries) {\n    if (\n      subject.registry === undefined ||\n      !adapter.includeRegistries.includes(subject.registry)\n    ) {\n      return false;\n    }\n  }\n\n  if (\n    adapter.excludeRegistries &&\n    subject.registry !== undefined &&\n    adapter.excludeRegistries.includes(subject.registry)\n  ) {\n    return false;\n  }\n\n  if (adapter.appliesTo && !adapter.appliesTo(subject)) {\n    return false;\n  }\n\n  return true;\n}\n\nexport interface Hcs25ComputeTrustScoreInput {\n  subject: Hcs25Subject;\n  snapshot: Hcs25SignalSnapshot;\n  config: Hcs25ScoringConfigInput;\n  now?: Date;\n}\n\n/**\n * Computes the composite AI Trust Score for a subject from a signal snapshot\n * and scoring configuration, following HCS-25 normalization, missing/stale\n * handling, applicability, and weighted-aggregation rules.\n */\nexport function computeTrustScore(\n  input: Hcs25ComputeTrustScoreInput,\n): Hcs25TrustScoreRecord {\n  const config = compileScoringConfig(input.config);\n  const subject = hcs25SubjectSchema.parse(input.subject);\n  const snapshot = hcs25SignalSnapshotSchema.parse(input.snapshot);\n  const context = { subject, snapshot, config };\n\n  const adapterScores: Hcs25AdapterScore[] = [];\n  const trustScores: Record<string, number> = {};\n\n  for (const adapter of config.adapters) {\n    const adapterScore = scoreAdapter(adapter, subject, context, config);\n    adapterScores.push(adapterScore);\n\n    if (adapterScore.applicable) {\n      for (const component of adapterScore.components) {\n        trustScores[component.key] = component.value;\n      }\n    }\n  }\n\n  const denominator = adapterScores.filter(score => score.inDenominator);\n  const totalWeight = denominator.reduce((sum, score) => sum + score.weight, 0);\n  const weightedSum = denominator.reduce(\n    (sum, score) => sum + score.total * score.weight,\n    0,\n  );\n  const total =\n    totalWeight > 0\n      ? roundScore(weightedSum / totalWeight, config.roundingDecimals)\n      : 0;\n\n  trustScores.total = total;\n\n  const record: Hcs25TrustScoreRecord = {\n    trustScore: total,\n    trustScores,\n    trustScoreConfigVersion: config.version,\n    trustScoreUpdatedAt: (input.now ?? new Date()).toISOString(),\n    breakdown: { adapters: adapterScores },\n  };\n\n  if (config.computeConfidence) {\n    record.trustConfidence = computeConfidence(denominator, totalWeight);\n  }\n\n  return record;\n}\n\nfunction scoreAdapter(\n  adapter: Hcs25AdapterDefinition,\n  subject: Hcs25Subject,\n  context: {\n    subject: Hcs25Subject;\n    snapshot: Hcs25SignalSnapshot;\n    config: Hcs25ScoringConfig;\n  },\n  config: Hcs25ScoringConfig,\n): Hcs25AdapterScore {\n  const weight = adapter.weight ?? HCS25_DEFAULT_WEIGHT;\n  const contributionMode: Hcs25ContributionMode =\n    adapter.contributionMode ?? HCS25_DEFAULT_CONTRIBUTION_MODE;\n  const applicable = isAdapterApplicable(adapter, subject);\n\n  const components: Hcs25ComponentResult[] = [];\n  const unavailable: string[] = [];\n\n  if (applicable) {\n    for (const component of adapter.components) {\n      const key = `${adapter.id}.${component.name}`;\n      const normalized = normalizeComponent(component.normalize(context));\n\n      if (normalized === null) {\n        if (component.nonScorableWhenUnavailable) {\n          unavailable.push(key);\n        } else {\n          components.push({\n            key,\n            value: 0,\n            status: 'missing',\n            weight: resolveWeight(component.weight),\n          });\n        }\n        continue;\n      }\n\n      const value =\n        normalized.status === 'stale'\n          ? clampScore(normalized.value * config.staleMultiplier)\n          : clampScore(normalized.value);\n\n      components.push({\n        key,\n        value,\n        status: normalized.status,\n        weight: resolveWeight(component.weight),\n      });\n    }\n\n    if (\n      components.length === 0 &&\n      contributionMode !== HCS25_DEFAULT_CONTRIBUTION_MODE\n    ) {\n      const defaultKey = adapter.defaultComponentKey ?? `${adapter.id}.score`;\n      components.push({\n        key: defaultKey,\n        value: 0,\n        status: 'missing',\n        weight: HCS25_DEFAULT_WEIGHT,\n      });\n    }\n  }\n\n  let inDenominator = false;\n  if (applicable) {\n    inDenominator =\n      contributionMode === 'conditional' ? components.length > 0 : true;\n    if (weight === 0) {\n      inDenominator = false;\n    }\n  }\n\n  return {\n    adapterId: adapter.id,\n    contributionMode,\n    applicable,\n    inDenominator,\n    weight,\n    components,\n    unavailable,\n    total: adapterTotal(components, config.roundingDecimals),\n  };\n}\n\nfunction normalizeComponent(\n  normalized: Hcs25NormalizedValue,\n): Hcs25NormalizedValue | null {\n  if (!Number.isFinite(normalized.value)) {\n    return null;\n  }\n\n  if (\n    normalized.status === 'missing' ||\n    normalized.status === 'timeout' ||\n    normalized.status === 'error'\n  ) {\n    return null;\n  }\n\n  return normalized;\n}\n\nfunction resolveWeight(weight: number | undefined): number {\n  return weight ?? HCS25_DEFAULT_WEIGHT;\n}\n\nfunction adapterTotal(\n  components: Hcs25ComponentResult[],\n  roundingDecimals: number,\n): number {\n  if (components.length === 0) {\n    return 0;\n  }\n\n  let weightedSum = 0;\n  let totalWeight = 0;\n  for (const component of components) {\n    weightedSum += component.value * component.weight;\n    totalWeight += component.weight;\n  }\n\n  const mean = totalWeight > 0 ? weightedSum / totalWeight : 0;\n  return roundScore(clampScore(mean), roundingDecimals);\n}\n\nfunction computeConfidence(\n  denominator: Hcs25AdapterScore[],\n  totalWeight: number,\n): number {\n  if (totalWeight <= 0) {\n    return 0;\n  }\n\n  let weightedSum = 0;\n  for (const adapter of denominator) {\n    const okCount = adapter.components.filter(\n      component => component.status === 'ok',\n    ).length;\n    const adapterConfidence =\n      adapter.components.length > 0 ? okCount / adapter.components.length : 0;\n    weightedSum += adapter.weight * adapterConfidence;\n  }\n\n  return roundScore(weightedSum / totalWeight, 4);\n}\n"],"names":[],"mappings":"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"}

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

@@ -1,4 +1,4 @@
-import { buildTopicCreateTx, buildMessageTx } from "./standards-sdk.es161.js";
+import { buildTopicCreateTx, buildMessageTx } from "./standards-sdk.es165.js";
 import { HCS7ConfigType, HCS7Operation } from "./standards-sdk.es8.js";
 function buildHcs7CreateRegistryTx(params) {
   const memo = `hcs-7:indexed:${params.ttl}`;