@hashgraphonline/standards-sdk 0.1.190 → 0.1.191

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

@@ -1,161 +1,156 @@
+import { readMetadataRecord, readString } from "./standards-sdk.es201.js";
+import "./standards-sdk.es184.js";
+import "./standards-sdk.es198.js";
+import "./standards-sdk.es199.js";
+import "./standards-sdk.es200.js";
+import "./standards-sdk.es183.js";
 import { resolveSubjectEndpoint } from "./standards-sdk.es127.js";
-import { isTimeoutError } from "./standards-sdk.es122.js";
-const MCP_PROTOCOL_VERSION = "2024-11-05";
-async function fetchOk(context, url, init) {
-  const response = await context.fetch(url, {
-    ...init,
-    signal: context.signal
-  });
-  return response.status < 500;
-}
-const mcpConnectivityProbe = async (subject, context) => {
-  const endpoint = resolveSubjectEndpoint(subject);
-  if (!endpoint) {
-    return null;
-  }
-  const ok = await fetchOk(context, endpoint, {
-    method: "POST",
-    headers: {
-      "content-type": "application/json",
-      accept: "application/json, text/event-stream"
-    },
-    body: JSON.stringify({
-      jsonrpc: "2.0",
-      id: 1,
-      method: "initialize",
-      params: {
-        protocolVersion: MCP_PROTOCOL_VERSION,
-        capabilities: {},
-        clientInfo: { name: "hcs-25-connectivity-probe", version: "1" }
-      }
-    })
-  });
-  return ok ? 100 : 0;
-};
-const a2aConnectivityProbe = async (subject, context) => {
-  const endpoint = resolveSubjectEndpoint(subject);
-  if (!endpoint) {
-    return null;
-  }
-  const cardUrl = endpoint.includes("/.well-known/") ? endpoint : new URL("/.well-known/agent.json", endpoint).toString();
-  const ok = await fetchOk(context, cardUrl);
-  return ok ? 100 : 0;
-};
-const httpConnectivityProbe = async (subject, context) => {
-  const endpoint = resolveSubjectEndpoint(subject);
-  if (!endpoint) {
-    return null;
-  }
-  const ok = await fetchOk(context, endpoint);
-  return ok ? 100 : 0;
-};
-const DEFAULT_PROBES = {
-  mcp: mcpConnectivityProbe,
-  a2a: a2aConnectivityProbe
-};
+import { Hcs25CollectorHttpError, isTimeoutError } from "./standards-sdk.es122.js";
 const DEFAULT_EXCLUDED_REGISTRIES = [
   "openrouter",
   "near-ai"
 ];
-function createConnectivitySignalAdapter(options = {}) {
-  const probes = { ...DEFAULT_PROBES, ...options.probes };
+function minutesSince(timestamp, now) {
+  const ms = Date.parse(timestamp);
+  if (Number.isNaN(ms)) {
+    return null;
+  }
+  return Math.max(0, (now.getTime() - ms) / 6e4);
+}
+function missingResult(now, reason) {
+  return [
+    {
+      signalId: "availability.probe",
+      status: "missing",
+      fields: [
+        {
+          scope: "root",
+          values: {
+            availabilityScore: null,
+            availabilityCheckedAt: now.toISOString(),
+            availabilityReason: reason,
+            availabilitySource: "probe",
+            availabilityStatus: "missing"
+          }
+        }
+      ]
+    }
+  ];
+}
+function createAvailabilitySignalAdapter(options = {}) {
+  const resolveEndpoint = options.resolveEndpoint ?? resolveSubjectEndpoint;
+  const method = options.method ?? "auto";
   const collect = async (subject, context) => {
-    const now = context.now;
-    const protocol = subject.protocol?.toLowerCase();
-    const protocolProbe = protocol ? probes[protocol] : void 0;
-    const defaultProbe = probes.default ?? httpConnectivityProbe;
-    const namedTargets = Object.keys(probes).filter(
-      (key) => key !== protocol && key !== "default" && !(key in DEFAULT_PROBES)
-    );
+    const { now } = context;
     const results = [];
-    const targets = {};
-    let primaryScore = null;
-    let primaryStatus = "ok";
-    let probed = false;
-    const runProbe = async (probe, signalId, target) => {
-      try {
-        const score = await probe(subject, context);
-        if (score === null) {
-          return;
-        }
-        probed = true;
-        const clamped = Math.min(100, Math.max(0, score));
-        if (target) {
-          targets[target] = clamped;
-        } else {
-          primaryScore = clamped;
-        }
+    const metrics = readMetadataRecord(subject, "metrics");
+    const lastActiveAt = metrics ? readString(metrics, "lastActiveAt") : null;
+    if (lastActiveAt !== null) {
+      const mins = minutesSince(lastActiveAt, now);
+      if (mins !== null) {
         results.push({
-          signalId,
+          signalId: "availability.last_seen",
           status: "ok",
-          value: clamped,
+          value: mins,
+          fields: [{ scope: "metrics", values: { minsFromLastOnline: mins } }],
           provenance: {
-            source: "connectivity-probe",
-            sourceUrl: resolveSubjectEndpoint(subject) ?? void 0,
-            subjectId: subject.id,
-            fetchedAt: now.toISOString()
-          }
-        });
-      } catch (error) {
-        probed = true;
-        const status = isTimeoutError(error) ? "timeout" : "error";
-        if (!target) {
-          primaryStatus = status;
-          primaryScore = 0;
-        }
-        results.push({
-          signalId,
-          status,
-          provenance: {
-            source: "connectivity-probe",
+            source: "metadata",
             subjectId: subject.id,
             fetchedAt: now.toISOString()
           }
         });
       }
-    };
-    await runProbe(protocolProbe ?? defaultProbe, "connectivity.probe");
-    for (const target of namedTargets) {
-      await runProbe(probes[target], `connectivity.${target}`, target);
     }
-    if (!probed) {
-      return [
-        {
-          signalId: "connectivity.probe",
-          status: "missing",
-          fields: [
-            {
-              scope: "additional",
-              values: { connectivityStatus: "missing" }
+    const endpoint = resolveEndpoint(subject);
+    if (!endpoint) {
+      if (results.length > 0) {
+        return results;
+      }
+      return missingResult(now, "no endpoint metadata");
+    }
+    const started = now.getTime();
+    try {
+      const attempt = async (verb) => {
+        const response = await context.fetch(endpoint, {
+          method: verb,
+          headers: options.headers,
+          signal: context.signal
+        });
+        return response.status;
+      };
+      let status;
+      if (method === "auto") {
+        try {
+          status = await attempt("HEAD");
+          if (status === 405 || status === 501) {
+            status = await attempt("GET");
+          }
+        } catch (error) {
+          if (error instanceof Hcs25CollectorHttpError) {
+            throw error;
+          }
+          status = await attempt("GET");
+        }
+      } else {
+        status = await attempt(method);
+      }
+      const latencyMs = Date.now() - started;
+      const reachable = status < 500;
+      results.push({
+        signalId: "availability.probe",
+        status: "ok",
+        value: reachable ? 1 : 0,
+        fields: [
+          {
+            scope: "root",
+            values: {
+              availabilityScore: reachable ? 1 : 0,
+              availabilityCheckedAt: now.toISOString(),
+              availabilityLatencyMs: latencyMs,
+              availabilityReason: reachable ? "reachable" : `endpoint returned HTTP ${status}`,
+              availabilitySource: "probe",
+              availabilityStatus: "ok"
             }
-          ]
+          }
+        ],
+        provenance: {
+          source: "probe",
+          sourceUrl: endpoint,
+          subjectId: subject.id,
+          fetchedAt: now.toISOString()
         }
-      ];
-    }
-    const additional = {
-      connectivityStatus: primaryStatus === "ok" ? "ok" : primaryStatus
-    };
-    if (primaryScore !== null) {
-      additional.connectivityScore = primaryScore;
-    }
-    if (Object.keys(targets).length > 0) {
-      additional.connectivityTargets = { ...targets };
+      });
+      return results;
+    } catch (error) {
+      const timedOut = isTimeoutError(error);
+      const statusValue = timedOut ? "timeout" : "error";
+      results.push({
+        signalId: "availability.probe",
+        status: statusValue,
+        fields: [
+          {
+            scope: "root",
+            values: {
+              availabilityCheckedAt: now.toISOString(),
+              availabilityReason: error instanceof Error ? error.message : String(error),
+              availabilitySource: "probe",
+              availabilityStatus: statusValue
+            }
+          }
+        ],
+        provenance: {
+          source: "probe",
+          sourceUrl: endpoint,
+          subjectId: subject.id,
+          fetchedAt: now.toISOString()
+        }
+      });
+      return results;
     }
-    const last = results[results.length - 1];
-    return [
-      ...results,
-      {
-        signalId: "connectivity.score",
-        status: primaryStatus === "ok" ? "ok" : primaryStatus,
-        value: primaryScore ?? void 0,
-        fields: [{ scope: "additional", values: additional }],
-        provenance: last?.provenance
-      }
-    ];
   };
   return {
-    id: "connectivity",
-    produces: ["connectivity.probe", "connectivity.score"],
+    id: "availability",
+    produces: ["availability.probe", "availability.last_seen"],
     timeoutMs: options.timeoutMs,
     includeRegistries: options.includeRegistries,
     excludeRegistries: options.excludeRegistries ?? DEFAULT_EXCLUDED_REGISTRIES,
@@ -164,9 +159,6 @@ function createConnectivitySignalAdapter(options = {}) {
   };
 }
 export {
-  a2aConnectivityProbe,
-  createConnectivitySignalAdapter,
-  httpConnectivityProbe,
-  mcpConnectivityProbe
+  createAvailabilitySignalAdapter
 };
 //# sourceMappingURL=standards-sdk.es129.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"standards-sdk.es129.js","sources":["../../src/hcs-25/collectors/connectivity.ts"],"sourcesContent":["import type { Hcs25JsonValue, Hcs25Subject } from '../types';\nimport { resolveSubjectEndpoint } from './endpoints';\nimport { isTimeoutError } from './http';\nimport type {\n  Hcs25CollectContext,\n  Hcs25SignalAdapter,\n  Hcs25SignalAdapterResult,\n} from './types';\n\n/**\n * A protocol probe: returns a connectivity score in `[0,100]`, or null when\n * the probe is not meaningful for the subject.\n */\nexport type Hcs25ConnectivityProbe = (\n  subject: Hcs25Subject,\n  context: Hcs25CollectContext,\n) => Promise<number | null>;\n\nconst MCP_PROTOCOL_VERSION = '2024-11-05';\n\nasync function fetchOk(\n  context: Hcs25CollectContext,\n  url: string,\n  init?: { method?: string; headers?: Record<string, string>; body?: string },\n): Promise<boolean> {\n  const response = await context.fetch(url, {\n    ...init,\n    signal: context.signal,\n  });\n  return response.status < 500;\n}\n\n/**\n * MCP probe: posts a JSON-RPC `initialize` request to the endpoint. Any\n * definite HTTP response (including 4xx such as 405 on SSE-only endpoints)\n * proves connectivity; only network failure or 5xx count as disconnected.\n */\nexport const mcpConnectivityProbe: Hcs25ConnectivityProbe = async (\n  subject,\n  context,\n) => {\n  const endpoint = resolveSubjectEndpoint(subject);\n  if (!endpoint) {\n    return null;\n  }\n  const ok = await fetchOk(context, endpoint, {\n    method: 'POST',\n    headers: {\n      'content-type': 'application/json',\n      accept: 'application/json, text/event-stream',\n    },\n    body: JSON.stringify({\n      jsonrpc: '2.0',\n      id: 1,\n      method: 'initialize',\n      params: {\n        protocolVersion: MCP_PROTOCOL_VERSION,\n        capabilities: {},\n        clientInfo: { name: 'hcs-25-connectivity-probe', version: '1' },\n      },\n    }),\n  });\n  return ok ? 100 : 0;\n};\n\n/**\n * A2A probe: fetches the agent card at `/.well-known/agent.json` relative to\n * the endpoint origin (or the endpoint itself when it already points at a\n * well-known path).\n */\nexport const a2aConnectivityProbe: Hcs25ConnectivityProbe = async (\n  subject,\n  context,\n) => {\n  const endpoint = resolveSubjectEndpoint(subject);\n  if (!endpoint) {\n    return null;\n  }\n  const cardUrl = endpoint.includes('/.well-known/')\n    ? endpoint\n    : new URL('/.well-known/agent.json', endpoint).toString();\n  const ok = await fetchOk(context, cardUrl);\n  return ok ? 100 : 0;\n};\n\n/**\n * Generic HTTP probe: GET the endpoint; any response below 500 counts as\n * connected.\n */\nexport const httpConnectivityProbe: Hcs25ConnectivityProbe = async (\n  subject,\n  context,\n) => {\n  const endpoint = resolveSubjectEndpoint(subject);\n  if (!endpoint) {\n    return null;\n  }\n  const ok = await fetchOk(context, endpoint);\n  return ok ? 100 : 0;\n};\n\nconst DEFAULT_PROBES: Record<string, Hcs25ConnectivityProbe> = {\n  mcp: mcpConnectivityProbe,\n  a2a: a2aConnectivityProbe,\n};\n\n/**\n * Options for the connectivity signal adapter.\n */\nexport interface Hcs25ConnectivitySignalAdapterOptions {\n  /**\n   * Probe map keyed by target name. Keys `mcp`/`a2a` are used automatically\n   * for matching `subject.protocol`; other keys run unconditionally as\n   * named targets and populate `connectivityTargets`. Pass `{default: fn}`\n   * to override the fallback HTTP probe.\n   */\n  probes?: Record<string, Hcs25ConnectivityProbe>;\n  /** Per-adapter timeout in milliseconds. */\n  timeoutMs?: number;\n  includeRegistries?: readonly string[];\n  excludeRegistries?: readonly string[];\n  appliesTo?: (subject: Hcs25Subject) => boolean;\n}\n\nconst DEFAULT_EXCLUDED_REGISTRIES: readonly string[] = [\n  'openrouter',\n  'near-ai',\n];\n\n/**\n * Creates the `connectivity` signal adapter: probes the subject's endpoint\n * using a protocol-aware probe (MCP initialize / A2A agent card / generic\n * HTTP) plus any named custom probes, and stores `connectivityScore` /\n * `connectivityTargets` under `metadata.additional`.\n */\nexport function createConnectivitySignalAdapter(\n  options: Hcs25ConnectivitySignalAdapterOptions = {},\n): Hcs25SignalAdapter {\n  const probes = { ...DEFAULT_PROBES, ...options.probes };\n\n  const collect = async (\n    subject: Hcs25Subject,\n    context: Hcs25CollectContext,\n  ): Promise<Hcs25SignalAdapterResult[]> => {\n    const now = context.now;\n    const protocol = subject.protocol?.toLowerCase();\n    const protocolProbe = protocol ? probes[protocol] : undefined;\n    const defaultProbe = probes.default ?? httpConnectivityProbe;\n    const namedTargets = Object.keys(probes).filter(\n      key => key !== protocol && key !== 'default' && !(key in DEFAULT_PROBES),\n    );\n\n    const results: Hcs25SignalAdapterResult[] = [];\n    const targets: Record<string, number> = {};\n    let primaryScore: number | null = null;\n    let primaryStatus: 'ok' | 'timeout' | 'error' = 'ok';\n    let probed = false;\n\n    const runProbe = async (\n      probe: Hcs25ConnectivityProbe,\n      signalId: string,\n      target?: string,\n    ): Promise<void> => {\n      try {\n        const score = await probe(subject, context);\n        if (score === null) {\n          return;\n        }\n        probed = true;\n        const clamped = Math.min(100, Math.max(0, score));\n        if (target) {\n          targets[target] = clamped;\n        } else {\n          primaryScore = clamped;\n        }\n        results.push({\n          signalId,\n          status: 'ok',\n          value: clamped,\n          provenance: {\n            source: 'connectivity-probe',\n            sourceUrl: resolveSubjectEndpoint(subject) ?? undefined,\n            subjectId: subject.id,\n            fetchedAt: now.toISOString(),\n          },\n        });\n      } catch (error) {\n        probed = true;\n        const status = isTimeoutError(error) ? 'timeout' : 'error';\n        if (!target) {\n          primaryStatus = status;\n          primaryScore = 0;\n        }\n        results.push({\n          signalId,\n          status,\n          provenance: {\n            source: 'connectivity-probe',\n            subjectId: subject.id,\n            fetchedAt: now.toISOString(),\n          },\n        });\n      }\n    };\n\n    await runProbe(protocolProbe ?? defaultProbe, 'connectivity.probe');\n\n    for (const target of namedTargets) {\n      await runProbe(probes[target], `connectivity.${target}`, target);\n    }\n\n    if (!probed) {\n      return [\n        {\n          signalId: 'connectivity.probe',\n          status: 'missing',\n          fields: [\n            {\n              scope: 'additional',\n              values: { connectivityStatus: 'missing' },\n            },\n          ],\n        },\n      ];\n    }\n\n    const additional: Record<string, Hcs25JsonValue> = {\n      connectivityStatus: primaryStatus === 'ok' ? 'ok' : primaryStatus,\n    };\n    if (primaryScore !== null) {\n      additional.connectivityScore = primaryScore;\n    }\n    if (Object.keys(targets).length > 0) {\n      additional.connectivityTargets = { ...targets };\n    }\n\n    const last = results[results.length - 1];\n    return [\n      ...results,\n      {\n        signalId: 'connectivity.score',\n        status: primaryStatus === 'ok' ? 'ok' : primaryStatus,\n        value: primaryScore ?? undefined,\n        fields: [{ scope: 'additional', values: additional }],\n        provenance: last?.provenance,\n      },\n    ];\n  };\n\n  return {\n    id: 'connectivity',\n    produces: ['connectivity.probe', 'connectivity.score'],\n    timeoutMs: options.timeoutMs,\n    includeRegistries: options.includeRegistries,\n    excludeRegistries: options.excludeRegistries ?? DEFAULT_EXCLUDED_REGISTRIES,\n    appliesTo: options.appliesTo,\n    collect,\n  };\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"standards-sdk.es129.js","sources":["../../src/hcs-25/collectors/availability.ts"],"sourcesContent":["import type { Hcs25Subject } from '../types';\nimport { readMetadataRecord, readString } from '../signals';\nimport { resolveSubjectEndpoint } from './endpoints';\nimport { Hcs25CollectorHttpError, isTimeoutError } from './http';\nimport type {\n  Hcs25CollectContext,\n  Hcs25SignalAdapter,\n  Hcs25SignalAdapterResult,\n} from './types';\n\n/**\n * Options for the availability signal adapter.\n */\nexport interface Hcs25AvailabilitySignalAdapterOptions {\n  /** Custom endpoint resolver; defaults to {@link resolveSubjectEndpoint}. */\n  resolveEndpoint?: (subject: Hcs25Subject) => string | null;\n  /** Probe method. `auto` (default) tries HEAD and falls back to GET. */\n  method?: 'auto' | 'HEAD' | 'GET';\n  /** Per-probe timeout in milliseconds. */\n  timeoutMs?: number;\n  /** Extra request headers (e.g. auth for gated endpoints). */\n  headers?: Record<string, string>;\n  /** Applicability constraints. */\n  includeRegistries?: readonly string[];\n  excludeRegistries?: readonly string[];\n  appliesTo?: (subject: Hcs25Subject) => boolean;\n}\n\nconst DEFAULT_EXCLUDED_REGISTRIES: readonly string[] = [\n  'openrouter',\n  'near-ai',\n];\n\nfunction minutesSince(timestamp: string, now: Date): number | null {\n  const ms = Date.parse(timestamp);\n  if (Number.isNaN(ms)) {\n    return null;\n  }\n  return Math.max(0, (now.getTime() - ms) / 60000);\n}\n\nfunction missingResult(now: Date, reason: string): Hcs25SignalAdapterResult[] {\n  return [\n    {\n      signalId: 'availability.probe',\n      status: 'missing',\n      fields: [\n        {\n          scope: 'root',\n          values: {\n            availabilityScore: null,\n            availabilityCheckedAt: now.toISOString(),\n            availabilityReason: reason,\n            availabilitySource: 'probe',\n            availabilityStatus: 'missing',\n          },\n        },\n      ],\n    },\n  ];\n}\n\n/**\n * Creates the `availability` signal adapter: probes the subject's endpoint,\n * records reachability, latency, and probe provenance, and converts the\n * ecosystem-native `metrics.lastActiveAt` field into\n * `metrics.minsFromLastOnline` (the deterministic scoring adapter consumes\n * the derived field). Unreachable endpoints score 0; absent endpoints are\n * `missing`.\n */\nexport function createAvailabilitySignalAdapter(\n  options: Hcs25AvailabilitySignalAdapterOptions = {},\n): Hcs25SignalAdapter {\n  const resolveEndpoint = options.resolveEndpoint ?? resolveSubjectEndpoint;\n  const method = options.method ?? 'auto';\n\n  const collect = async (\n    subject: Hcs25Subject,\n    context: Hcs25CollectContext,\n  ): Promise<Hcs25SignalAdapterResult[]> => {\n    const { now } = context;\n    const results: Hcs25SignalAdapterResult[] = [];\n\n    const metrics = readMetadataRecord(subject, 'metrics');\n    const lastActiveAt = metrics ? readString(metrics, 'lastActiveAt') : null;\n    if (lastActiveAt !== null) {\n      const mins = minutesSince(lastActiveAt, now);\n      if (mins !== null) {\n        results.push({\n          signalId: 'availability.last_seen',\n          status: 'ok',\n          value: mins,\n          fields: [{ scope: 'metrics', values: { minsFromLastOnline: mins } }],\n          provenance: {\n            source: 'metadata',\n            subjectId: subject.id,\n            fetchedAt: now.toISOString(),\n          },\n        });\n      }\n    }\n\n    const endpoint = resolveEndpoint(subject);\n    if (!endpoint) {\n      if (results.length > 0) {\n        return results;\n      }\n      return missingResult(now, 'no endpoint metadata');\n    }\n\n    const started = now.getTime();\n    try {\n      const attempt = async (verb: 'HEAD' | 'GET'): Promise<number> => {\n        const response = await context.fetch(endpoint, {\n          method: verb,\n          headers: options.headers,\n          signal: context.signal,\n        });\n        return response.status;\n      };\n\n      let status: number;\n      if (method === 'auto') {\n        try {\n          status = await attempt('HEAD');\n          if (status === 405 || status === 501) {\n            status = await attempt('GET');\n          }\n        } catch (error) {\n          if (error instanceof Hcs25CollectorHttpError) {\n            throw error;\n          }\n          status = await attempt('GET');\n        }\n      } else {\n        status = await attempt(method);\n      }\n\n      const latencyMs = Date.now() - started;\n      const reachable = status < 500;\n      results.push({\n        signalId: 'availability.probe',\n        status: 'ok',\n        value: reachable ? 1 : 0,\n        fields: [\n          {\n            scope: 'root',\n            values: {\n              availabilityScore: reachable ? 1 : 0,\n              availabilityCheckedAt: now.toISOString(),\n              availabilityLatencyMs: latencyMs,\n              availabilityReason: reachable\n                ? 'reachable'\n                : `endpoint returned HTTP ${status}`,\n              availabilitySource: 'probe',\n              availabilityStatus: 'ok',\n            },\n          },\n        ],\n        provenance: {\n          source: 'probe',\n          sourceUrl: endpoint,\n          subjectId: subject.id,\n          fetchedAt: now.toISOString(),\n        },\n      });\n      return results;\n    } catch (error) {\n      const timedOut = isTimeoutError(error);\n      const statusValue = timedOut ? 'timeout' : 'error';\n      results.push({\n        signalId: 'availability.probe',\n        status: statusValue,\n        fields: [\n          {\n            scope: 'root',\n            values: {\n              availabilityCheckedAt: now.toISOString(),\n              availabilityReason:\n                error instanceof Error ? error.message : String(error),\n              availabilitySource: 'probe',\n              availabilityStatus: statusValue,\n            },\n          },\n        ],\n        provenance: {\n          source: 'probe',\n          sourceUrl: endpoint,\n          subjectId: subject.id,\n          fetchedAt: now.toISOString(),\n        },\n      });\n      return results;\n    }\n  };\n\n  return {\n    id: 'availability',\n    produces: ['availability.probe', 'availability.last_seen'],\n    timeoutMs: options.timeoutMs,\n    includeRegistries: options.includeRegistries,\n    excludeRegistries: options.excludeRegistries ?? DEFAULT_EXCLUDED_REGISTRIES,\n    appliesTo: options.appliesTo,\n    collect,\n  };\n}\n"],"names":[],"mappings":"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"}

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

@@ -1,4 +1,4 @@
-import { Logger } from "./standards-sdk.es147.js";
+import { Logger } from "./standards-sdk.es148.js";
 class WasmBridge {
   constructor() {
     this.wasm = null;