@abtnode/util 1.17.6-beta-20251216-223535-283b9ffe → 1.17.6-beta-20251217-144034-62fafb94

package/lib/did-document.js

@@ -3,6 +3,7 @@ const { toBase64, toBase58, toDid } = require('@ocap/util');
 const { joinURL } = require('ufo');
 const pRetry = require('p-retry');
 const debug = require('debug')('@abtnode/util:did-document');
+const { BLOCKLET_CONFIGURABLE_KEY } = require('@blocklet/constant');
 
 const sleep = require('./sleep');
 const axios = require('./axios');
@@ -20,8 +21,17 @@ const getDID = (address) => {
   return `did:abt:${address}`;
 };
 
-const update = async ({ id, services, didRegistryUrl, wallet, alsoKnownAs = [], blockletServerVersion }) => {
-  debug('update did document', { didRegistryUrl });
+const update = async ({
+  id,
+  services,
+  didRegistryUrl,
+  wallet,
+  alsoKnownAs = [],
+  blockletServerVersion,
+  name,
+  capabilities,
+}) => {
+  debug('starting update did document', { didRegistryUrl });
 
   const did = getDID(wallet.address);
   const time = new Date().toISOString();
@@ -45,6 +55,14 @@ const update = async ({ id, services, didRegistryUrl, wallet, alsoKnownAs = [],
     updated: time,
   };
 
+  if (name) {
+    document.name = name;
+  }
+
+  if (capabilities) {
+    document.capabilities = capabilities;
+  }
+
   const proof = {
     type: 'Ed25519Signature',
     created: time,
@@ -63,6 +81,8 @@ const update = async ({ id, services, didRegistryUrl, wallet, alsoKnownAs = [],
 };
 
 const DEFAULT_RETRY_COUNT = 6;
+const DEFAULT_DEBOUNCE_TIME = 3000;
+
 const getRetryCount = () => {
   try {
     let retryCount = parseInt(process.env.ABT_NODE_UPDATE_DID_DOCUMENT_RETRY_COUNT, 10);
@@ -75,14 +95,60 @@ const getRetryCount = () => {
   }
 };
 
-const updateWithRetry = (...args) =>
-  pRetry(() => update(...args), {
-    retries: getRetryCount(),
-    onFailedAttempt: async (error) => {
-      debug('update did document failed', error);
-      await sleep(10 * 1000);
-    },
+const getDebounceTime = () => {
+  try {
+    let debounceTime = parseInt(process.env.ABT_NODE_DID_DOCUMENT_DEBOUNCE_TIME, 10);
+    debounceTime = Number.isNaN(debounceTime) ? DEFAULT_DEBOUNCE_TIME : debounceTime;
+    return debounceTime;
+  } catch (error) {
+    return DEFAULT_DEBOUNCE_TIME;
+  }
+};
+
+const pendingUpdates = new Map();
+const updateTimers = new Map();
+
+const updateWithRetry = (...args) => {
+  const params = args[0];
+  const did = toDid(params.id);
+
+  return new Promise((resolve, reject) => {
+    if (updateTimers.has(did)) {
+      clearTimeout(updateTimers.get(did));
+      debug('cancelled pending update for did', { did });
+    }
+
+    pendingUpdates.set(did, { args, resolve, reject });
+
+    const timer = setTimeout(async () => {
+      const pending = pendingUpdates.get(did);
+      pendingUpdates.delete(did);
+      updateTimers.delete(did);
+
+      if (!pending) {
+        return;
+      }
+
+      debug('executing debounced update for did', { did });
+
+      try {
+        const result = await pRetry(() => update(...pending.args), {
+          retries: getRetryCount(),
+          onFailedAttempt: async (error) => {
+            debug('update did document failed', error);
+            await sleep(10 * 1000);
+          },
+        });
+        pending.resolve(result);
+      } catch (error) {
+        pending.reject(error);
+      }
+    }, getDebounceTime());
+
+    updateTimers.set(did, timer);
+    debug('scheduled update for did', { did, debounceTime: getDebounceTime() });
   });
+};
 
 const getServerServices = ({ ips, wallet, domain }) => {
   const records = ips.map((ip) => ({
@@ -148,6 +214,83 @@ const updateServerDocument = async ({ ips, wallet, didRegistryUrl, domain, block
   return updateWithRetry({ id: getDID(wallet.address), services, didRegistryUrl, wallet, blockletServerVersion });
 };
 
+// Fetch existing DID document from registry
+const getDidDocument = async ({ did, didRegistryUrl }) => {
+  const fullDid = getDID(did);
+  const resolveUrl = joinURL(didRegistryUrl, '/.well-known/did-resolver/resolve', fullDid);
+
+  debug('fetching did document', { did: fullDid, resolveUrl });
+
+  const response = await axios.get(resolveUrl, {
+    timeout: 10 * 1000,
+  });
+
+  return response.data?.didDocument || null;
+};
+
+// Internal function to update blocklet state only
+const updateBlockletStateOnlyInternal = async ({ did, state, didRegistryUrl, wallet, blockletServerVersion }) => {
+  if (['0', 'false', 0, false].includes(process.env.ABT_NODE_DID_DOCUMENT_UPDATE)) {
+    throw new Error('Did Document update is disabled');
+  }
+
+  debug('updating blocklet state only', { did, state });
+
+  // Fetch current DID document from registry
+  const currentDoc = await getDidDocument({ did, didRegistryUrl });
+
+  if (!currentDoc) {
+    throw new Error(`Failed to fetch DID document for ${did} from registry`);
+  }
+
+  // Only update state if the path exists
+  if (currentDoc.capabilities?.blocklet?.metadata) {
+    currentDoc.capabilities.blocklet.metadata.state = state;
+  } else {
+    throw new Error(`DID document for ${did} does not have capabilities.blocklet.metadata structure`);
+  }
+
+  // Update timestamp
+  const time = new Date().toISOString();
+  currentDoc.updated = time;
+
+  // Remove old proof before re-signing
+  delete currentDoc.proof;
+
+  // Generate new proof with updated document
+  const controllerDid = getDID(wallet.address);
+  const proof = {
+    type: 'Ed25519Signature',
+    created: time,
+    verificationMethod: `${controllerDid}#key-1`,
+    jws: toBase64(await wallet.sign(stringify(currentDoc))),
+  };
+
+  currentDoc.proof = proof;
+
+  debug('update blocklet state only - sending to registry', { did, state, didRegistryUrl });
+
+  // Send directly to registry without reconstructing
+  return axios.post(joinURL(didRegistryUrl, '/.well-known/did-resolver/registries'), currentDoc, {
+    timeout: 10 * 1000,
+    headers: { 'X-Blocklet-Server-Version': blockletServerVersion },
+  });
+};
+
+// Update only blocklet state (e.g., to 'deleted') by fetching current document from registry with retry
+// This function preserves the complete DID document structure and only modifies the state field
+const updateBlockletStateOnly = (params) => {
+  debug('updateBlockletStateOnly with retry', { did: params.did });
+
+  return pRetry(() => updateBlockletStateOnlyInternal(params), {
+    retries: getRetryCount(),
+    onFailedAttempt: async (error) => {
+      debug('update blocklet state only failed', error);
+      await sleep(10 * 1000);
+    },
+  });
+};
+
 const updateBlockletDocument = ({
   blocklet,
   slpDid,
@@ -159,6 +302,11 @@ const updateBlockletDocument = ({
   alsoKnownAs = [],
   serverDid,
   blockletServerVersion,
+  name,
+  state,
+  owner,
+  launcher,
+  domains,
 }) => {
   const { appPid } = blocklet;
   if (['0', 'false', 0, false].includes(process.env.ABT_NODE_DID_DOCUMENT_UPDATE)) {
@@ -166,16 +314,58 @@ const updateBlockletDocument = ({
   }
 
   const services = getBlockletServices({ appPid, slpDid, daemonDidDomain, domain, slpDomain, serverDid });
-  return updateWithRetry({ id: appPid, services, didRegistryUrl, alsoKnownAs, wallet, blockletServerVersion });
+
+  const tagMap = new Set(blocklet.meta?.keywords || []);
+  tagMap.add('type:blocklet');
+
+  const metadata = {
+    name: blocklet.environments.find((x) => x.key === BLOCKLET_CONFIGURABLE_KEY.BLOCKLET_APP_NAME)?.value,
+    description: blocklet.environments.find((x) => x.key === BLOCKLET_CONFIGURABLE_KEY.BLOCKLET_APP_DESCRIPTION)?.value,
+    icon: blocklet.environments.find((x) => x.key === BLOCKLET_CONFIGURABLE_KEY.BLOCKLET_APP_LOGO)?.value,
+    tags: [],
+    state,
+    owner,
+  };
+
+  if (launcher) {
+    tagMap.add('launcher:app');
+    metadata.launcher = launcher;
+  }
+
+  metadata.tags = Array.from(tagMap);
+
+  const capabilities = {
+    blocklet: {
+      metadata,
+      domains,
+    },
+  };
+
+  debug('update blocklet document', { appPid, capabilities });
+
+  return updateWithRetry({
+    id: appPid,
+    services,
+    didRegistryUrl,
+    alsoKnownAs,
+    wallet,
+    blockletServerVersion,
+    name,
+    capabilities,
+  });
 };
 
 module.exports = {
   DEFAULT_RETRY_COUNT,
+  DEFAULT_DEBOUNCE_TIME,
   updateServerDocument,
   updateBlockletDocument,
+  updateBlockletStateOnly,
+  getDidDocument,
   getDID,
   getServerServices,
   getBlockletServices,
   updateWithRetry,
   getRetryCount,
+  getDebounceTime,
 };

package/package.json

@@ -3,7 +3,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "1.17.6-beta-20251216-223535-283b9ffe",
+  "version": "1.17.6-beta-20251217-144034-62fafb94",
   "description": "ArcBlock's JavaScript utility",
   "main": "lib/index.js",
   "files": [
@@ -18,14 +18,14 @@
   "author": "polunzh <polunzh@gmail.com> (http://github.com/polunzh)",
   "license": "Apache-2.0",
   "dependencies": {
-    "@abtnode/constant": "1.17.6-beta-20251216-223535-283b9ffe",
-    "@abtnode/db-cache": "1.17.6-beta-20251216-223535-283b9ffe",
+    "@abtnode/constant": "1.17.6-beta-20251217-144034-62fafb94",
+    "@abtnode/db-cache": "1.17.6-beta-20251217-144034-62fafb94",
     "@arcblock/did": "^1.27.15",
     "@arcblock/event-hub": "^1.27.15",
     "@arcblock/pm2": "^6.0.12",
-    "@blocklet/constant": "1.17.6-beta-20251216-223535-283b9ffe",
+    "@blocklet/constant": "1.17.6-beta-20251217-144034-62fafb94",
     "@blocklet/error": "^0.3.5",
-    "@blocklet/meta": "1.17.6-beta-20251216-223535-283b9ffe",
+    "@blocklet/meta": "1.17.6-beta-20251217-144034-62fafb94",
     "@blocklet/xss": "^0.3.13",
     "@ocap/client": "^1.27.15",
     "@ocap/mcrypto": "^1.27.15",
@@ -79,7 +79,7 @@
     "through2-filter": "^3.0.0",
     "through2-map": "^3.0.0",
     "to-semver": "^3.0.0",
-    "transliteration": "^2.3.5",
+    "transliteration": "2.3.5",
     "ufo": "^1.5.3",
     "which": "^2.0.2"
   },
@@ -90,5 +90,5 @@
     "express": "^4.18.2",
     "fs-extra": "^11.2.0"
   },
-  "gitHead": "00f2aa2d19ce17e3e15b8ab7a200830f633e9030"
+  "gitHead": "9f47bf4e66af87c562f846e5470f45491506ab36"
 }