@hashgraphonline/standards-sdk 0.1.162 → 0.1.164

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

@@ -1,203 +1,537 @@
-import { parseSemicolonFields } from "./standards-sdk.es159.js";
-const ANS_HCS27_REGISTRY = "ans";
-function isObjectRecord(value) {
-  return typeof value === "object" && value !== null;
-}
-function asString(value) {
-  if (typeof value !== "string") {
-    return null;
-  }
-  const trimmed = value.trim();
-  if (!trimmed) {
-    return null;
-  }
-  return trimmed;
-}
-function isSemver(value) {
-  return /^(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)(?:-[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*)?(?:\+[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*)?$/.test(
-    value
-  );
-}
-function normalizeAnsVersion(value) {
-  const trimmed = value.trim();
-  if (!trimmed) {
-    return null;
-  }
-  const withoutPrefix = trimmed.startsWith("v") || trimmed.startsWith("V") ? trimmed.slice(1) : trimmed;
-  if (!isSemver(withoutPrefix)) {
-    return null;
-  }
-  return withoutPrefix;
-}
-function parseAnsDnsTxtRecord(rawRecord) {
-  const fields = parseSemicolonFields(rawRecord);
-  const version = fields["v"];
-  const urlValue = fields["url"];
-  if (!version || !urlValue || version.toLowerCase() !== "ans1") {
-    return null;
-  }
-  let parsedUrl;
-  try {
-    parsedUrl = new URL(urlValue);
-  } catch {
-    return null;
-  }
-  if (parsedUrl.protocol.toLowerCase() !== "https:") {
-    return null;
-  }
-  const rawAnsVersion = fields["version"];
-  let normalizedAnsVersion;
-  if (rawAnsVersion !== void 0) {
-    const parsedVersion = normalizeAnsVersion(rawAnsVersion);
-    if (!parsedVersion) {
-      return null;
+import { skillRegistryConfigResponseSchema, skillRegistryListResponseSchema, skillCatalogResponseSchema, skillRegistryVersionsResponseSchema, skillRegistryMineResponseSchema, skillRegistryMyListResponseSchema, skillRegistryQuoteResponseSchema, skillRegistryPublishResponseSchema, skillRegistryJobStatusResponseSchema, skillRegistryOwnershipResponseSchema, skillRecommendedVersionResponseSchema, skillDeprecationsResponseSchema, skillDeprecationRecordSchema, skillBadgeResponseSchema, skillRegistryTagsResponseSchema, skillRegistryCategoriesResponseSchema, skillResolverManifestResponseSchema, skillRegistryVoteStatusResponseSchema, skillVerificationRequestCreateResponseSchema, skillVerificationStatusResponseSchema, skillVerificationDomainProofChallengeResponseSchema, skillVerificationDomainProofVerifyResponseSchema } from "./standards-sdk.es140.js";
+async function skillsConfig(client) {
+  const raw = await client.requestJson("/skills/config", {
+    method: "GET"
+  });
+  return client.parseWithSchema(
+    raw,
+    skillRegistryConfigResponseSchema,
+    "skill registry config response"
+  );
+}
+async function listSkills(client, params = {}) {
+  const query = new URLSearchParams();
+  if (params.name) {
+    query.set("name", params.name);
+  }
+  if (params.version) {
+    query.set("version", params.version);
+  }
+  if (typeof params.limit === "number" && Number.isFinite(params.limit)) {
+    query.set("limit", String(Math.trunc(params.limit)));
+  }
+  if (params.cursor) {
+    query.set("cursor", params.cursor);
+  }
+  if (typeof params.includeFiles === "boolean") {
+    query.set("includeFiles", params.includeFiles ? "true" : "false");
+  }
+  if (params.accountId) {
+    query.set("accountId", params.accountId);
+  }
+  if (params.q) {
+    query.set("q", params.q);
+  }
+  if (params.tag) {
+    query.set("tag", params.tag);
+  }
+  if (params.category) {
+    query.set("category", params.category);
+  }
+  if (typeof params.featured === "boolean") {
+    query.set("featured", params.featured ? "true" : "false");
+  }
+  if (typeof params.verified === "boolean") {
+    query.set("verified", params.verified ? "true" : "false");
+  }
+  if (params.view) {
+    query.set("view", params.view);
+  }
+  const suffix = query.size > 0 ? `?${query.toString()}` : "";
+  const raw = await client.requestJson(`/skills${suffix}`, {
+    method: "GET"
+  });
+  return client.parseWithSchema(
+    raw,
+    skillRegistryListResponseSchema,
+    "skill registry list response"
+  );
+}
+async function getSkillsCatalog(client, params = {}) {
+  const query = new URLSearchParams();
+  if (params.q) {
+    query.set("q", params.q);
+  }
+  if (params.category) {
+    query.set("category", params.category);
+  }
+  params.tags?.forEach((tag) => {
+    if (tag.trim()) {
+      query.append("tag", tag.trim());
     }
-    normalizedAnsVersion = parsedVersion;
+  });
+  if (typeof params.featured === "boolean") {
+    query.set("featured", params.featured ? "true" : "false");
+  }
+  if (typeof params.verified === "boolean") {
+    query.set("verified", params.verified ? "true" : "false");
+  }
+  if (params.channel) {
+    query.set("channel", params.channel);
+  }
+  if (params.sortBy) {
+    query.set("sortBy", params.sortBy);
   }
-  return {
-    version: normalizedAnsVersion,
-    url: parsedUrl.toString()
-  };
+  if (typeof params.limit === "number" && Number.isFinite(params.limit)) {
+    query.set("limit", String(Math.trunc(params.limit)));
+  }
+  if (params.cursor) {
+    query.set("cursor", params.cursor);
+  }
+  const suffix = query.size > 0 ? `?${query.toString()}` : "";
+  const raw = await client.requestJson(`/skills/catalog${suffix}`, {
+    method: "GET"
+  });
+  return client.parseWithSchema(
+    raw,
+    skillCatalogResponseSchema,
+    "skill catalog response"
+  );
 }
-function isValidAnsProfileVersion(value) {
-  return !!value && normalizeAnsVersion(value) !== null;
+async function listSkillVersions(client, params) {
+  const normalizedName = params.name.trim();
+  if (!normalizedName) {
+    throw new Error("name is required");
+  }
+  const query = new URLSearchParams();
+  query.set("name", normalizedName);
+  const raw = await client.requestJson(
+    `/skills/versions?${query.toString()}`,
+    { method: "GET" }
+  );
+  return client.parseWithSchema(
+    raw,
+    skillRegistryVersionsResponseSchema,
+    "skill registry versions response"
+  );
 }
-function hasProtocolPathSegment(pathname, protocol) {
-  const normalizedProtocol = protocol.trim().toLowerCase();
-  if (!normalizedProtocol) {
-    return false;
+async function listMySkills(client, params = {}) {
+  const query = new URLSearchParams();
+  if (typeof params.limit === "number" && Number.isFinite(params.limit)) {
+    query.set("limit", String(Math.trunc(params.limit)));
   }
-  const pathSegments = pathname.split("/").map((segment) => segment.trim()).filter((segment) => segment.length > 0);
-  for (const segment of pathSegments) {
-    if (segment.toLowerCase() === normalizedProtocol) {
-      return true;
+  const suffix = query.size > 0 ? `?${query.toString()}` : "";
+  const raw = await client.requestJson(`/skills/mine${suffix}`, {
+    method: "GET"
+  });
+  return client.parseWithSchema(
+    raw,
+    skillRegistryMineResponseSchema,
+    "skill registry mine response"
+  );
+}
+async function getMySkillsList(client, params = {}) {
+  const query = new URLSearchParams();
+  if (typeof params.limit === "number" && Number.isFinite(params.limit)) {
+    query.set("limit", String(Math.trunc(params.limit)));
+  }
+  if (params.cursor) {
+    query.set("cursor", params.cursor);
+  }
+  if (params.accountId) {
+    query.set("accountId", params.accountId);
+  }
+  const suffix = query.size > 0 ? `?${query.toString()}` : "";
+  const raw = await client.requestJson(`/skills/my-list${suffix}`, {
+    method: "GET"
+  });
+  return client.parseWithSchema(
+    raw,
+    skillRegistryMyListResponseSchema,
+    "skill registry my list response"
+  );
+}
+async function quoteSkillPublish(client, payload) {
+  const raw = await client.requestJson("/skills/quote", {
+    method: "POST",
+    body: payload,
+    headers: { "content-type": "application/json" }
+  });
+  return client.parseWithSchema(
+    raw,
+    skillRegistryQuoteResponseSchema,
+    "skill registry quote response"
+  );
+}
+async function publishSkill(client, payload) {
+  const raw = await client.requestJson("/skills/publish", {
+    method: "POST",
+    body: payload,
+    headers: { "content-type": "application/json" }
+  });
+  return client.parseWithSchema(
+    raw,
+    skillRegistryPublishResponseSchema,
+    "skill registry publish response"
+  );
+}
+async function getSkillPublishJob(client, jobId, params = {}) {
+  const normalized = jobId.trim();
+  if (!normalized) {
+    throw new Error("jobId is required");
+  }
+  const query = new URLSearchParams();
+  if (params.accountId) {
+    query.set("accountId", params.accountId);
+  }
+  const suffix = query.size > 0 ? `?${query.toString()}` : "";
+  const raw = await client.requestJson(
+    `/skills/jobs/${encodeURIComponent(normalized)}${suffix}`,
+    { method: "GET" }
+  );
+  return client.parseWithSchema(
+    raw,
+    skillRegistryJobStatusResponseSchema,
+    "skill registry job status response"
+  );
+}
+async function getSkillOwnership(client, params) {
+  const normalizedName = params.name.trim();
+  if (!normalizedName) {
+    throw new Error("name is required");
+  }
+  const query = new URLSearchParams();
+  query.set("name", normalizedName);
+  if (params.accountId) {
+    query.set("accountId", params.accountId);
+  }
+  const raw = await client.requestJson(
+    `/skills/ownership?${query.toString()}`,
+    {
+      method: "GET"
     }
+  );
+  return client.parseWithSchema(
+    raw,
+    skillRegistryOwnershipResponseSchema,
+    "skill registry ownership response"
+  );
+}
+async function getRecommendedSkillVersion(client, params) {
+  const normalizedName = params.name.trim();
+  if (!normalizedName) {
+    throw new Error("name is required");
   }
-  return false;
+  const query = new URLSearchParams();
+  query.set("name", normalizedName);
+  const raw = await client.requestJson(
+    `/skills/recommended?${query.toString()}`,
+    { method: "GET" }
+  );
+  return client.parseWithSchema(
+    raw,
+    skillRecommendedVersionResponseSchema,
+    "skill recommended version response"
+  );
 }
-function extractEndpointCandidates(endpoints, supportedSchemes) {
-  const candidates = [];
-  for (const [key, value] of Object.entries(endpoints)) {
-    if (!isObjectRecord(value)) {
-      continue;
+async function setRecommendedSkillVersion(client, payload) {
+  const normalizedName = payload.name.trim();
+  const normalizedVersion = payload.version.trim();
+  if (!normalizedName) {
+    throw new Error("name is required");
+  }
+  if (!normalizedVersion) {
+    throw new Error("version is required");
+  }
+  const raw = await client.requestJson("/skills/recommended", {
+    method: "POST",
+    body: {
+      name: normalizedName,
+      version: normalizedVersion
+    },
+    headers: { "content-type": "application/json" }
+  });
+  return client.parseWithSchema(
+    raw,
+    skillRecommendedVersionResponseSchema,
+    "skill recommended version response"
+  );
+}
+async function getSkillDeprecations(client, params) {
+  const normalizedName = params.name.trim();
+  if (!normalizedName) {
+    throw new Error("name is required");
+  }
+  const query = new URLSearchParams();
+  query.set("name", normalizedName);
+  const raw = await client.requestJson(
+    `/skills/deprecations?${query.toString()}`,
+    { method: "GET" }
+  );
+  return client.parseWithSchema(
+    raw,
+    skillDeprecationsResponseSchema,
+    "skill deprecations response"
+  );
+}
+async function setSkillDeprecation(client, payload) {
+  const normalizedName = payload.name.trim();
+  if (!normalizedName) {
+    throw new Error("name is required");
+  }
+  const version = payload.version?.trim();
+  const reason = payload.reason.trim();
+  if (!reason) {
+    throw new Error("reason is required");
+  }
+  const replacementRef = payload.replacementRef?.trim();
+  const raw = await client.requestJson("/skills/deprecate", {
+    method: "POST",
+    body: {
+      name: normalizedName,
+      version,
+      reason,
+      replacementRef
+    },
+    headers: { "content-type": "application/json" }
+  });
+  return client.parseWithSchema(
+    raw,
+    skillDeprecationRecordSchema,
+    "skill deprecation response"
+  );
+}
+async function getSkillBadge(client, params) {
+  const normalizedName = params.name.trim();
+  if (!normalizedName) {
+    throw new Error("name is required");
+  }
+  const query = new URLSearchParams();
+  query.set("name", normalizedName);
+  if (params.metric) {
+    query.set("metric", params.metric);
+  }
+  if (params.label?.trim()) {
+    query.set("label", params.label.trim());
+  }
+  if (params.style) {
+    query.set("style", params.style);
+  }
+  const raw = await client.requestJson(
+    `/skills/badge?${query.toString()}`,
+    { method: "GET" }
+  );
+  return client.parseWithSchema(
+    raw,
+    skillBadgeResponseSchema,
+    "skill badge response"
+  );
+}
+async function listSkillTags(client) {
+  const raw = await client.requestJson("/skills/tags", {
+    method: "GET"
+  });
+  return client.parseWithSchema(
+    raw,
+    skillRegistryTagsResponseSchema,
+    "skill tags response"
+  );
+}
+async function listSkillCategories(client) {
+  const raw = await client.requestJson("/skills/categories", {
+    method: "GET"
+  });
+  return client.parseWithSchema(
+    raw,
+    skillRegistryCategoriesResponseSchema,
+    "skill categories response"
+  );
+}
+async function resolveSkillMarkdown(client, skillRef) {
+  const normalizedSkillRef = skillRef.trim();
+  if (!normalizedSkillRef) {
+    throw new Error("skillRef is required");
+  }
+  const response = await client.request(
+    `/skills/${encodeURIComponent(normalizedSkillRef)}/SKILL.md`,
+    {
+      method: "GET",
+      headers: {
+        accept: "text/markdown, text/plain;q=0.9, */*;q=0.8"
+      }
+    }
+  );
+  return response.text();
+}
+async function resolveSkillManifest(client, skillRef) {
+  const normalizedSkillRef = skillRef.trim();
+  if (!normalizedSkillRef) {
+    throw new Error("skillRef is required");
+  }
+  const raw = await client.requestJson(
+    `/skills/${encodeURIComponent(normalizedSkillRef)}/manifest`,
+    {
+      method: "GET"
     }
-    const endpoint = asString(value["url"]);
-    if (!endpoint) {
-      continue;
+  );
+  return client.parseWithSchema(
+    raw,
+    skillResolverManifestResponseSchema,
+    "skill resolver manifest response"
+  );
+}
+async function getSkillVoteStatus(client, params) {
+  const normalizedName = params.name.trim();
+  if (!normalizedName) {
+    throw new Error("name is required");
+  }
+  const query = new URLSearchParams();
+  query.set("name", normalizedName);
+  const raw = await client.requestJson(
+    `/skills/vote?${query.toString()}`,
+    { method: "GET" }
+  );
+  return client.parseWithSchema(
+    raw,
+    skillRegistryVoteStatusResponseSchema,
+    "skill registry vote status response"
+  );
+}
+async function setSkillVote(client, payload) {
+  const normalizedName = payload.name.trim();
+  if (!normalizedName) {
+    throw new Error("name is required");
+  }
+  const raw = await client.requestJson("/skills/vote", {
+    method: "POST",
+    body: { name: normalizedName, upvoted: payload.upvoted },
+    headers: { "content-type": "application/json" }
+  });
+  return client.parseWithSchema(
+    raw,
+    skillRegistryVoteStatusResponseSchema,
+    "skill registry vote status response"
+  );
+}
+async function requestSkillVerification(client, payload) {
+  const normalizedName = payload.name.trim();
+  if (!normalizedName) {
+    throw new Error("name is required");
+  }
+  const raw = await client.requestJson(
+    "/skills/verification/request",
+    {
+      method: "POST",
+      body: {
+        name: normalizedName,
+        version: payload.version,
+        tier: payload.tier
+      },
+      headers: { "content-type": "application/json" }
     }
-    let parsedUrl;
-    try {
-      parsedUrl = new URL(endpoint);
-    } catch {
-      continue;
+  );
+  return client.parseWithSchema(
+    raw,
+    skillVerificationRequestCreateResponseSchema,
+    "skill verification request create response"
+  );
+}
+async function getSkillVerificationStatus(client, params) {
+  const normalizedName = params.name.trim();
+  if (!normalizedName) {
+    throw new Error("name is required");
+  }
+  const query = new URLSearchParams();
+  query.set("name", normalizedName);
+  if (params.version) {
+    query.set("version", params.version);
+  }
+  const raw = await client.requestJson(
+    `/skills/verification/status?${query.toString()}`,
+    { method: "GET" }
+  );
+  return client.parseWithSchema(
+    raw,
+    skillVerificationStatusResponseSchema,
+    "skill verification status response"
+  );
+}
+async function createSkillDomainProofChallenge(client, payload) {
+  const normalizedName = payload.name.trim();
+  if (!normalizedName) {
+    throw new Error("name is required");
+  }
+  const raw = await client.requestJson(
+    "/skills/verification/domain/challenge",
+    {
+      method: "POST",
+      body: {
+        name: normalizedName,
+        version: payload.version,
+        domain: payload.domain
+      },
+      headers: { "content-type": "application/json" }
     }
-    const scheme = parsedUrl.protocol.replace(/:$/, "").toLowerCase();
-    if (!supportedSchemes.has(scheme)) {
-      continue;
+  );
+  return client.parseWithSchema(
+    raw,
+    skillVerificationDomainProofChallengeResponseSchema,
+    "skill domain proof challenge response"
+  );
+}
+async function verifySkillDomainProof(client, payload) {
+  const normalizedName = payload.name.trim();
+  const challengeToken = payload.challengeToken.trim();
+  if (!normalizedName) {
+    throw new Error("name is required");
+  }
+  if (!challengeToken) {
+    throw new Error("challengeToken is required");
+  }
+  const raw = await client.requestJson(
+    "/skills/verification/domain/verify",
+    {
+      method: "POST",
+      body: {
+        name: normalizedName,
+        version: payload.version,
+        domain: payload.domain,
+        challengeToken
+      },
+      headers: { "content-type": "application/json" }
     }
-    candidates.push({
-      key,
-      endpointUrl: parsedUrl.toString(),
-      parsedUrl
-    });
-  }
-  return candidates;
-}
-function validateAnsHcs27Hints(input) {
-  if (!isObjectRecord(input)) {
-    return void 0;
-  }
-  const checkpointTopicId = asString(input["checkpoint_topic_id"]);
-  const registry = asString(input["registry"]);
-  const logId = asString(input["log_id"]);
-  if (!checkpointTopicId || !registry || !logId || registry !== ANS_HCS27_REGISTRY) {
-    return void 0;
-  }
-  const checkpointUri = asString(input["checkpoint_uri"]) ?? void 0;
-  const viewerUri = asString(input["viewer_uri"]) ?? void 0;
-  return {
-    checkpointTopicId,
-    registry,
-    logId,
-    checkpointUri,
-    viewerUri
-  };
-}
-function validateHcs28Hints(input) {
-  if (!isObjectRecord(input)) {
-    return void 0;
-  }
-  const directoryTopicId = asString(input["directory_topic_id"]);
-  const tId = asString(input["t_id"]);
-  const agentId = asString(input["agent_id"]);
-  if (!directoryTopicId || !tId || !agentId) {
-    return void 0;
-  }
-  const proofProfile = asString(input["proof_profile"]) ?? void 0;
-  return {
-    directoryTopicId,
-    tId,
-    agentId,
-    proofProfile
-  };
-}
-function parseTransparencyHints(input) {
-  if (!isObjectRecord(input)) {
-    return void 0;
-  }
-  const hcs27 = validateAnsHcs27Hints(input["hcs27"]);
-  const hcs28 = validateHcs28Hints(input["hcs28"]);
-  if (!hcs27 && !hcs28) {
-    return void 0;
-  }
-  return {
-    hcs27,
-    hcs28
-  };
-}
-function parseAnsAgentCard(input) {
-  if (!isObjectRecord(input)) {
-    return null;
-  }
-  const ansName = asString(input["ansName"]);
-  const endpoints = input["endpoints"];
-  if (!ansName || !isObjectRecord(endpoints)) {
-    return null;
-  }
-  return {
-    ansName,
-    endpoints,
-    transparencyHints: parseTransparencyHints(input["transparency"])
-  };
-}
-function selectPreferredEndpoint(candidates, protocol) {
-  if (candidates.length === 0) {
-    return null;
-  }
-  const sortedCandidates = [...candidates].sort(
-    (a, b) => a.key.localeCompare(b.key)
-  );
-  const protocolMatches = sortedCandidates.filter(
-    (candidate) => hasProtocolPathSegment(candidate.parsedUrl.pathname, protocol)
-  );
-  if (protocolMatches.length > 0) {
-    return protocolMatches[0];
-  }
-  return sortedCandidates[0];
-}
-function toErrorMessage(error) {
-  if (error instanceof Error && error.message) {
-    return error.message;
-  }
-  return null;
+  );
+  return client.parseWithSchema(
+    raw,
+    skillVerificationDomainProofVerifyResponseSchema,
+    "skill domain proof verify response"
+  );
 }
 export {
-  extractEndpointCandidates,
-  isValidAnsProfileVersion,
-  normalizeAnsVersion,
-  parseAnsAgentCard,
-  parseAnsDnsTxtRecord,
-  selectPreferredEndpoint,
-  toErrorMessage
+  createSkillDomainProofChallenge,
+  getMySkillsList,
+  getRecommendedSkillVersion,
+  getSkillBadge,
+  getSkillDeprecations,
+  getSkillOwnership,
+  getSkillPublishJob,
+  getSkillVerificationStatus,
+  getSkillVoteStatus,
+  getSkillsCatalog,
+  listMySkills,
+  listSkillCategories,
+  listSkillTags,
+  listSkillVersions,
+  listSkills,
+  publishSkill,
+  quoteSkillPublish,
+  requestSkillVerification,
+  resolveSkillManifest,
+  resolveSkillMarkdown,
+  setRecommendedSkillVersion,
+  setSkillDeprecation,
+  setSkillVote,
+  skillsConfig,
+  verifySkillDomainProof
 };
 //# sourceMappingURL=standards-sdk.es160.js.map