@hashgraphonline/standards-sdk 0.1.190 → 0.1.191

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

@@ -1,236 +1,396 @@
-import { readString } from "./standards-sdk.es198.js";
-import "./standards-sdk.es182.js";
-import "./standards-sdk.es195.js";
-import "./standards-sdk.es196.js";
-import "./standards-sdk.es197.js";
-import { requestJson, Hcs25CollectorHttpError, isTimeoutError } from "./standards-sdk.es122.js";
-const parsePositiveInt = (value) => {
-  if (typeof value === "number" && Number.isFinite(value)) {
-    const normalized = Math.floor(value);
-    return normalized > 0 ? normalized : null;
+import { readString, readSubjectAdditional, isJsonObject } 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 { requestJson, requestText, Hcs25CollectorHttpError, isTimeoutError } from "./standards-sdk.es122.js";
+const GITHUB_API_BASE = "https://api.github.com";
+const NPM_API_BASE = "https://api.npmjs.org";
+const NPM_REGISTRY_BASE = "https://registry.npmjs.org";
+const PYPISTATS_API_BASE = "https://pypistats.org/api";
+const PYPI_API_BASE = "https://pypi.org/pypi";
+const RAW_GITHUB_BASE = "https://raw.githubusercontent.com";
+const GITHUB_REPO_PATTERN = /github\.com[:/]+([A-Za-z0-9_.-]+)\/([A-Za-z0-9_.-]+)/;
+function parseGithubRepo(value) {
+  if (!value) {
+    return null;
   }
-  if (typeof value === "string") {
-    const trimmed = value.trim();
-    if (!trimmed) {
-      return null;
-    }
-    const parsed = Number.parseInt(trimmed, 10);
-    return Number.isFinite(parsed) && parsed > 0 ? parsed : null;
+  const direct = value.match(/^([A-Za-z0-9_.-]+)\/([A-Za-z0-9_.-]+)$/);
+  if (direct) {
+    return `${direct[1]}/${direct[2]}`;
   }
-  return null;
-};
-const parseNonNegativeInt = (value) => {
-  if (typeof value === "number" && Number.isFinite(value)) {
-    const normalized = Math.floor(value);
-    return normalized >= 0 ? normalized : null;
+  const match = value.match(GITHUB_REPO_PATTERN);
+  if (!match) {
+    return null;
   }
-  if (typeof value === "string") {
-    const trimmed = value.trim();
-    if (!trimmed) {
-      return null;
+  return `${match[1]}/${match[2].replace(/\.git$/, "")}`;
+}
+function resolveGithubRepo(subject) {
+  const additional = readSubjectAdditional(subject);
+  const metadata = subject.metadata ?? {};
+  const mcp = isJsonObject(metadata.mcp) ? metadata.mcp : void 0;
+  for (const value of [
+    readString(additional, "githubRepo"),
+    readString(additional, "repository"),
+    readString(metadata, "repository"),
+    readString(mcp, "repository"),
+    readString(metadata, "repoUrl"),
+    readString(additional, "repoUrl"),
+    readString(metadata, "homepage"),
+    readString(additional, "homepage"),
+    resolveSubjectEndpoint(subject)
+  ]) {
+    const repo = parseGithubRepo(value);
+    if (repo) {
+      return repo;
     }
-    const parsed = Number.parseInt(trimmed, 10);
-    return Number.isFinite(parsed) && parsed >= 0 ? parsed : null;
   }
   return null;
-};
-const parseChainIdFromNetworkKey = (networkKey) => {
-  if (typeof networkKey !== "string") {
-    return null;
+}
+function resolvePackage(subject) {
+  const additional = readSubjectAdditional(subject);
+  const registry = readString(additional, "packageRegistry");
+  const name = readString(additional, "packageName");
+  if (name && (registry === "npm" || registry === "pypi")) {
+    return { registry, name };
   }
-  const trimmed = networkKey.trim();
-  if (!trimmed) {
-    return null;
+  if (name) {
+    return { registry: "npm", name };
   }
-  const match = /^eip155:(\d+)(?::|$)/i.exec(trimmed);
-  if (!match) {
-    return null;
+  return null;
+}
+function statusFromError(error) {
+  if (error instanceof Hcs25CollectorHttpError && error.status === 404) {
+    return "missing";
   }
-  const parsed = Number.parseInt(match[1], 10);
-  return Number.isFinite(parsed) && parsed > 0 ? parsed : null;
-};
-const parseIdParts = (value) => {
-  if (typeof value !== "string") {
+  return isTimeoutError(error) ? "timeout" : "error";
+}
+const parseLikelyPackageName = (value) => {
+  if (!value) {
     return null;
   }
   const trimmed = value.trim();
-  if (!trimmed) {
+  return /^[a-zA-Z0-9._~@/-]{1,214}$/.test(trimmed) ? trimmed : null;
+};
+const parseNpmPackageName = (body) => {
+  try {
+    const parsed = JSON.parse(body);
+    return typeof parsed.name === "string" ? parsed.name : null;
+  } catch {
     return null;
   }
-  const separator = trimmed.indexOf(":");
-  if (separator <= 0 || separator !== trimmed.lastIndexOf(":")) {
-    return null;
+};
+const parsePyProjectName = (body) => {
+  const match = body.match(/^\s*name\s*=\s*["']([^"']+)["']/m);
+  return match?.[1] ?? null;
+};
+const parseSetupCfgName = (body) => {
+  const match = body.match(/^\s*name\s*=\s*(\S+)\s*$/m);
+  return match?.[1] ?? null;
+};
+async function inferPackageIdentity(repo, context) {
+  const base = `${RAW_GITHUB_BASE}/${repo.split("/").map(encodeURIComponent).join("/")}`;
+  let npmName = null;
+  let pypiName = null;
+  for (const branch of ["main", "master"]) {
+    if (!npmName) {
+      try {
+        const body = await requestText(`${base}/${branch}/package.json`, {
+          fetch: context.fetch,
+          timeoutMs: context.timeoutMs,
+          signal: context.signal
+        });
+        npmName = parseLikelyPackageName(parseNpmPackageName(body));
+      } catch {
+      }
+    }
+    if (!pypiName) {
+      try {
+        const body = await requestText(`${base}/${branch}/pyproject.toml`, {
+          fetch: context.fetch,
+          timeoutMs: context.timeoutMs,
+          signal: context.signal
+        });
+        pypiName = parseLikelyPackageName(parsePyProjectName(body));
+      } catch {
+        try {
+          const body = await requestText(`${base}/${branch}/setup.cfg`, {
+            fetch: context.fetch,
+            timeoutMs: context.timeoutMs,
+            signal: context.signal
+          });
+          pypiName = parseLikelyPackageName(parseSetupCfgName(body));
+        } catch {
+        }
+      }
+    }
+    if (npmName || pypiName) {
+      break;
+    }
   }
-  const chainId = Number.parseInt(trimmed.slice(0, separator), 10);
-  const agentId = trimmed.slice(separator + 1);
-  if (!Number.isFinite(chainId) || chainId <= 0 || !agentId) {
-    return null;
+  if (npmName && !pypiName) {
+    return { registry: "npm", name: npmName };
   }
-  return { chainId, agentId };
-};
-function parseErc8004NativeId(subject) {
-  const metadata = subject.metadata ?? {};
-  const idParts = parseIdParts(readString(metadata, "originalId")) ?? parseIdParts(readString(metadata, "nativeId")) ?? parseIdParts(readString(metadata, "uid"));
-  const agentId = parseNonNegativeInt(metadata["agentId"]) ?? (idParts ? parseNonNegativeInt(idParts.agentId) : null);
-  const chainId = parsePositiveInt(metadata["chainId"]) ?? parseChainIdFromNetworkKey(metadata["networkKey"]) ?? idParts?.chainId ?? null;
-  if (agentId === null || chainId === null) {
-    return null;
+  if (pypiName && !npmName) {
+    return { registry: "pypi", name: pypiName };
   }
-  return { chainId, agentId: String(agentId) };
+  return null;
 }
-function createHttpErc8004FeedbackSource(options) {
-  return {
-    async getFeedbackSummary(subject, context) {
-      const nativeId = parseErc8004NativeId(subject);
-      if (!nativeId) {
-        return null;
+async function inferRepositoryFromPackage(pkg, context) {
+  const candidates = [];
+  try {
+    if (pkg.registry === "pypi") {
+      const payload = await requestJson(`${PYPI_API_BASE}/${encodeURIComponent(pkg.name)}/json`, {
+        fetch: context.fetch,
+        timeoutMs: context.timeoutMs,
+        signal: context.signal
+      });
+      const home = payload.info?.home_page;
+      if (typeof home === "string") {
+        candidates.push(home);
       }
-      const url = typeof options.endpoint === "function" ? options.endpoint(subject) : options.endpoint.replace("{nativeId}", `${nativeId.chainId}:${nativeId.agentId}`).replace("{chainId}", String(nativeId.chainId)).replace("{agentId}", nativeId.agentId);
-      if (!url) {
-        return null;
+      const urls = payload.info?.project_urls;
+      if (urls && typeof urls === "object" && !Array.isArray(urls)) {
+        for (const value of Object.values(urls)) {
+          if (typeof value === "string") {
+            candidates.push(value);
+          }
+        }
       }
-      const data = await requestJson(url, {
+    } else {
+      const payload = await requestJson(`${NPM_REGISTRY_BASE}/${encodeURIComponent(pkg.name)}`, {
         fetch: context.fetch,
         timeoutMs: context.timeoutMs,
         signal: context.signal
       });
-      const summary = data.summary ?? data;
-      const averageScore = typeof summary.averageScore === "number" ? summary.averageScore : null;
-      const totalFeedbacks = typeof summary.totalFeedbacks === "number" ? summary.totalFeedbacks : typeof data.count === "number" ? data.count : null;
-      if (averageScore === null && totalFeedbacks === null) {
-        return null;
+      const repo = payload.repository && typeof payload.repository === "object" && !Array.isArray(payload.repository) ? payload.repository.url : payload.repository;
+      if (typeof repo === "string") {
+        candidates.push(repo);
       }
-      return {
-        averageScore: averageScore ?? 0,
-        totalFeedbacks: totalFeedbacks ?? 0,
-        registry: summary.registry ?? "erc-8004",
-        network: summary.network ?? String(nativeId.chainId),
-        updatedAt: summary.updatedAt
-      };
-    }
-  };
-}
-const ERC8004_REPUTATION_ABI = [
-  "function getClients(uint256 agentId) view returns (address[])",
-  "function getSummary(uint256 agentId, address[] clientAddresses, string tag1, string tag2) view returns (uint64 count, int128 summaryValue, uint8 summaryValueDecimals)"
-];
-function createOnchainErc8004FeedbackSource(options) {
-  const scoreScale = options.scoreScale ?? "auto";
-  return {
-    async getFeedbackSummary(subject) {
-      const nativeId = parseErc8004NativeId(subject);
-      if (!nativeId) {
-        return null;
+      if (typeof payload.homepage === "string") {
+        candidates.push(payload.homepage);
       }
-      const registry = options.registries[nativeId.chainId];
-      if (!registry) {
-        return null;
+      const bugs = payload.bugs && typeof payload.bugs === "object" && !Array.isArray(payload.bugs) ? payload.bugs.url : payload.bugs;
+      if (typeof bugs === "string") {
+        candidates.push(bugs);
       }
-      const contract = options.contractFor(nativeId.chainId, registry);
-      const agentId = BigInt(nativeId.agentId);
-      const clients = await contract.getClients(agentId);
-      if (clients.length === 0) {
-        return {
-          averageScore: 0,
-          totalFeedbacks: 0,
-          network: String(nativeId.chainId)
-        };
-      }
-      const [count, summaryValue, decimals] = await contract.getSummary(
-        agentId,
-        [...clients],
-        options.tag1 ?? "",
-        options.tag2 ?? ""
-      );
-      const raw = Number(summaryValue) / 10 ** Number(decimals);
-      const averageScore = scoreScale === "ratio5" ? raw * 20 : scoreScale === "percent" ? raw : raw <= 5 ? raw * 20 : raw;
-      return {
-        averageScore: Math.min(100, Math.max(0, averageScore)),
-        totalFeedbacks: Number(count),
-        network: String(nativeId.chainId)
-      };
     }
-  };
+  } catch {
+    return null;
+  }
+  for (const candidate of candidates) {
+    const repo = parseGithubRepo(candidate);
+    if (repo) {
+      return repo;
+    }
+  }
+  return null;
 }
-const DEFAULT_INCLUDED_REGISTRIES = ["erc-8004"];
-function statusFromError(error) {
-  return isTimeoutError(error) ? "timeout" : "error";
+async function fetchGithubStarsViaHtml(repo, context) {
+  const url = `https://github.com/${repo.split("/").map(encodeURIComponent).join("/")}`;
+  const body = await requestText(url, {
+    fetch: context.fetch,
+    timeoutMs: context.timeoutMs,
+    signal: context.signal,
+    headers: { accept: "text/html" }
+  });
+  const match = body.match(
+    /id="repo-stars-counter-star"[^>]*aria-label="(?<count>[0-9,]+)\s+users?\s+starred/i
+  ) ?? body.match(/id="repo-stars-counter-star"[^>]*title="(?<count>[0-9,]+)"/i);
+  const raw = match?.groups?.count;
+  if (!raw) {
+    return null;
+  }
+  const parsed = Number(raw.replace(/,/g, ""));
+  return Number.isFinite(parsed) ? Math.max(0, Math.floor(parsed)) : null;
 }
-function createErc8004SignalAdapter(options) {
+function createOssPopularitySignalAdapter(options = {}) {
   const collect = async (subject, context) => {
     const now = context.now.toISOString();
-    const nativeId = parseErc8004NativeId(subject);
-    if (!nativeId) {
-      return [{ signalId: "erc8004.feedback", status: "missing" }];
+    let repo = resolveGithubRepo(subject);
+    let pkg = resolvePackage(subject);
+    if (!repo && pkg && options.inferRepository !== false) {
+      repo = await inferRepositoryFromPackage(pkg, context).catch(
+        () => null
+      );
+    }
+    if (!pkg && repo && options.inferPackageIdentity !== false) {
+      pkg = await inferPackageIdentity(repo, context).catch(() => null);
     }
-    let lastError = null;
-    for (const source of options.sources) {
+    const results = [];
+    const additional = {};
+    if (repo) {
+      additional.githubRepo = repo;
+      additional.packageRepositoryUpdatedAt = now;
       try {
-        const summary = await source.getFeedbackSummary(subject, context);
-        if (!summary) {
-          continue;
-        }
-        const averageScore = Math.min(
-          100,
-          Math.max(0, Number(summary.averageScore) || 0)
-        );
-        const totalFeedbacks = Math.max(
-          0,
-          Math.floor(Number(summary.totalFeedbacks) || 0)
-        );
-        const record = {
-          averageScore,
-          totalFeedbacks,
-          registry: summary.registry ?? subject.registry ?? "erc-8004",
-          network: summary.network ?? String(nativeId.chainId),
-          updatedAt: summary.updatedAt ?? now
+        const headers = {
+          accept: "application/vnd.github+json"
         };
-        return [
-          {
-            signalId: "erc8004.feedback",
-            status: "ok",
-            value: averageScore,
-            fields: [{ scope: "erc8004FeedbackSummary", values: record }],
+        if (options.githubToken) {
+          headers.authorization = `Bearer ${options.githubToken}`;
+        }
+        let stars = null;
+        try {
+          const data = await requestJson(
+            `${options.githubApiBase ?? GITHUB_API_BASE}/repos/${repo}`,
+            {
+              fetch: context.fetch,
+              headers,
+              timeoutMs: context.timeoutMs,
+              signal: context.signal
+            }
+          );
+          stars = typeof data.stargazers_count === "number" ? Math.max(0, Math.floor(data.stargazers_count)) : null;
+        } catch (error) {
+          if (options.githubHtmlFallback === false) {
+            throw error;
+          }
+        }
+        if (stars === null && options.githubHtmlFallback !== false) {
+          stars = await fetchGithubStarsViaHtml(repo, context).catch(
+            () => null
+          );
+        }
+        additional.githubStars = stars;
+        additional.githubStarsUpdatedAt = now;
+        results.push({
+          signalId: "oss.github_stars",
+          status: stars === null ? "missing" : "ok",
+          value: stars,
+          provenance: {
+            source: "github",
+            sourceUrl: `${options.githubApiBase ?? GITHUB_API_BASE}/repos/${repo}`,
+            subjectId: repo,
+            fetchedAt: now
+          }
+        });
+      } catch (error) {
+        results.push({
+          signalId: "oss.github_stars",
+          status: statusFromError(error),
+          provenance: {
+            source: "github",
+            subjectId: repo,
+            fetchedAt: now
+          }
+        });
+      }
+    }
+    if (pkg) {
+      additional.packageRegistry = pkg.registry;
+      additional.packageName = pkg.name;
+      additional.packageIdentityUpdatedAt = now;
+      const signalId = pkg.registry === "npm" ? "oss.npm_downloads" : "oss.pypi_downloads";
+      try {
+        if (pkg.registry === "npm") {
+          const data = await requestJson(
+            `${options.npmApiBase ?? NPM_API_BASE}/downloads/point/last-month/${encodeURIComponent(pkg.name)}`,
+            {
+              fetch: context.fetch,
+              timeoutMs: context.timeoutMs,
+              signal: context.signal
+            }
+          );
+          const downloads = typeof data.downloads === "number" ? Math.max(0, Math.floor(data.downloads)) : null;
+          additional.npmDownloads30d = downloads;
+          additional.npmDownloadsUpdatedAt = now;
+          if (downloads !== null) {
+            additional.packageDownloadCount = downloads;
+          }
+          results.push({
+            signalId,
+            status: downloads === null ? "missing" : "ok",
+            value: downloads,
             provenance: {
-              source: "erc8004",
-              subjectId: `${nativeId.chainId}:${nativeId.agentId}`,
+              source: "npm",
+              subjectId: pkg.name,
               fetchedAt: now
             }
+          });
+        } else {
+          const data = await requestJson(
+            `${options.pypiApiBase ?? PYPISTATS_API_BASE}/packages/${encodeURIComponent(pkg.name)}/recent`,
+            {
+              fetch: context.fetch,
+              timeoutMs: context.timeoutMs,
+              signal: context.signal
+            }
+          );
+          const downloads = typeof data.data?.last_month === "number" ? Math.max(0, Math.floor(data.data.last_month)) : null;
+          additional.pypiDownloads30d = downloads;
+          additional.pypiDownloadsUpdatedAt = now;
+          if (downloads !== null) {
+            additional.packageDownloadCount = downloads;
           }
-        ];
+          results.push({
+            signalId,
+            status: downloads === null ? "missing" : "ok",
+            value: downloads,
+            provenance: {
+              source: "pypi",
+              subjectId: pkg.name,
+              fetchedAt: now
+            }
+          });
+        }
       } catch (error) {
-        lastError = error;
-        continue;
+        results.push({
+          signalId,
+          status: statusFromError(error),
+          provenance: {
+            source: pkg.registry,
+            subjectId: pkg.name,
+            fetchedAt: now
+          }
+        });
       }
     }
-    if (lastError) {
-      if (lastError instanceof Hcs25CollectorHttpError && lastError.status === 404) {
-        return [{ signalId: "erc8004.feedback", status: "missing" }];
-      }
+    if (results.length === 0) {
       return [
         {
-          signalId: "erc8004.feedback",
-          status: statusFromError(lastError)
+          signalId: "oss.github_stars",
+          status: "missing"
         }
       ];
     }
-    return [{ signalId: "erc8004.feedback", status: "missing" }];
+    const rootValues = {};
+    if (repo && !readString(subject.metadata ?? {}, "repository")) {
+      rootValues.repository = `https://github.com/${repo}`;
+    }
+    results.push({
+      signalId: "oss.popularity",
+      status: "ok",
+      fields: [
+        { scope: "additional", values: additional },
+        ...Object.keys(rootValues).length > 0 ? [{ scope: "root", values: rootValues }] : []
+      ],
+      provenance: {
+        source: "oss-popularity",
+        subjectId: subject.id,
+        fetchedAt: now
+      }
+    });
+    return results;
   };
   return {
-    id: "erc8004-feedback",
-    produces: ["erc8004.feedback"],
+    id: "oss-popularity",
+    produces: [
+      "oss.github_stars",
+      "oss.npm_downloads",
+      "oss.pypi_downloads",
+      "oss.popularity"
+    ],
     timeoutMs: options.timeoutMs,
-    includeRegistries: options.includeRegistries ?? DEFAULT_INCLUDED_REGISTRIES,
+    includeRegistries: options.includeRegistries,
     excludeRegistries: options.excludeRegistries,
     appliesTo: options.appliesTo,
     collect
   };
 }
 export {
-  ERC8004_REPUTATION_ABI,
-  createErc8004SignalAdapter,
-  createHttpErc8004FeedbackSource,
-  createOnchainErc8004FeedbackSource,
-  parseErc8004NativeId
+  createOssPopularitySignalAdapter,
+  parseGithubRepo
 };
 //# sourceMappingURL=standards-sdk.es132.js.map