@blocklet/meta 1.8.65 → 1.8.66-beta-7f4224af

package/lib/channel.d.ts

@@ -1,27 +1,32 @@
 declare const getAppPublicChannelRegex: () => RegExp;
+declare const getRelayChannelRegex: () => RegExp;
 declare const getAppPublicChannel: (appDid: string) => string;
+declare const getRelayChannel: (appDid: string, topic: string) => string;
 declare const CHANNEL_TYPE: {
     DID: string;
     APP: string;
+    RELAY: string;
 };
 declare const parseChannel: (channel: string) => {
     type: string;
     appDid?: string;
+    topic?: string;
 };
-export { CHANNEL_TYPE };
-export { getAppPublicChannel };
-export { getAppPublicChannelRegex };
-export { parseChannel };
+export { CHANNEL_TYPE, getAppPublicChannel, getAppPublicChannelRegex, getRelayChannel, getRelayChannelRegex, parseChannel, };
 declare const _default: {
     CHANNEL_TYPE: {
         DID: string;
         APP: string;
+        RELAY: string;
     };
     getAppPublicChannel: (appDid: string) => string;
     getAppPublicChannelRegex: () => RegExp;
+    getRelayChannel: (appDid: string, topic: string) => string;
+    getRelayChannelRegex: () => RegExp;
     parseChannel: (channel: string) => {
         type: string;
         appDid?: string;
+        topic?: string;
     };
 };
 export default _default;

package/lib/channel.js

@@ -1,26 +1,39 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.parseChannel = exports.getAppPublicChannelRegex = exports.getAppPublicChannel = exports.CHANNEL_TYPE = void 0;
+exports.parseChannel = exports.getRelayChannelRegex = exports.getRelayChannel = exports.getAppPublicChannelRegex = exports.getAppPublicChannel = exports.CHANNEL_TYPE = void 0;
 /* eslint-disable @typescript-eslint/indent */
 const did_1 = require("@arcblock/did");
 const getAppPublicChannelRegex = () => /app:(\w+):public/;
 exports.getAppPublicChannelRegex = getAppPublicChannelRegex;
+const getRelayChannelRegex = () => /relay:(\w+):(\w+)/;
+exports.getRelayChannelRegex = getRelayChannelRegex;
 const getAppPublicChannel = (appDid) => `app:${appDid}:public`;
 exports.getAppPublicChannel = getAppPublicChannel;
+const getRelayChannel = (appDid, topic) => `relay:${appDid}:${topic}`;
+exports.getRelayChannel = getRelayChannel;
 const CHANNEL_TYPE = {
     DID: 'DID',
     APP: 'APP',
+    RELAY: 'RELAY',
 };
 exports.CHANNEL_TYPE = CHANNEL_TYPE;
 const parseChannel = (channel) => {
     if (!channel) {
         throw new Error('Channel should not be empty');
     }
-    const matchAppPublicChannel = getAppPublicChannelRegex().exec(channel);
-    if (matchAppPublicChannel) {
+    let match = getRelayChannelRegex().exec(channel);
+    if (match && (0, did_1.isValid)(match[1])) {
+        return {
+            type: CHANNEL_TYPE.RELAY,
+            appDid: match[1],
+            topic: match[2],
+        };
+    }
+    match = getAppPublicChannelRegex().exec(channel);
+    if (match && (0, did_1.isValid)(match[1])) {
         return {
             type: CHANNEL_TYPE.APP,
-            appDid: matchAppPublicChannel[1],
+            appDid: match[1],
         };
     }
     if ((0, did_1.isValid)(channel)) {
@@ -35,5 +48,7 @@ exports.default = {
     CHANNEL_TYPE,
     getAppPublicChannel,
     getAppPublicChannelRegex,
+    getRelayChannel,
+    getRelayChannelRegex,
     parseChannel,
 };

package/lib/did.js

@@ -3,6 +3,9 @@ const mcrypto_1 = require("@ocap/mcrypto");
 const util_1 = require("@ocap/util");
 const did_1 = require("@arcblock/did");
 const toBlockletDid = (name) => {
+    if ((0, did_1.isValid)(name)) {
+        return name;
+    }
     const pk = (0, util_1.toHex)(Buffer.from(typeof name === 'string' ? name.trim() : name));
     return (0, did_1.fromPublicKey)(pk, { role: mcrypto_1.types.RoleType.ROLE_ANY });
 };

package/lib/extension.d.ts

@@ -1,5 +1,9 @@
 import { Extension, Root } from 'joi';
 declare const fileExtension: (joi: Root) => Extension;
+/**
+ * joi extend did 判断
+ * 由于需要兼容新旧两种 did 模式判断，所以这里不能做 role 类型判断
+ */
 declare const didExtension: (joi: Root) => Extension;
 export { fileExtension };
 export { didExtension };

package/lib/extension.js

@@ -60,6 +60,10 @@ const fileExtension = (joi) => ({
     },
 });
 exports.fileExtension = fileExtension;
+/**
+ * joi extend did 判断
+ * 由于需要兼容新旧两种 did 模式判断，所以这里不能做 role 类型判断
+ */
 const didExtension = (joi) => ({
     type: 'DID',
     base: joi.string(),

package/lib/file.d.ts

@@ -6,7 +6,9 @@ declare const select: (dir: string, { throwOnError }?: {
 declare const update: (file: string, meta: TBlockletMeta, { fix }?: {
     fix?: boolean;
 }) => void;
+declare const read: (file: string) => unknown;
 export { list };
+export { read };
 export { select };
 export { update };
 declare const _default: {

package/lib/file.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.update = exports.select = exports.list = void 0;
+exports.update = exports.select = exports.read = exports.list = void 0;
 const path_1 = __importDefault(require("path"));
 const js_yaml_1 = __importDefault(require("js-yaml"));
 const fs_extra_1 = __importDefault(require("fs-extra"));
@@ -43,6 +43,11 @@ const update = (file, meta, { fix = true } = {}) => {
     fs_extra_1.default.writeFileSync(file, js_yaml_1.default.dump(meta, { sortKeys: false, skipInvalid: true }));
 };
 exports.update = update;
+const read = (file) => {
+    const fileContent = fs_extra_1.default.readFileSync(file, 'utf8').toString();
+    return js_yaml_1.default.load(fileContent);
+};
+exports.read = read;
 exports.default = {
     list,
     select,

package/lib/fix.d.ts

@@ -8,12 +8,14 @@ declare const formatPerson: (person: string | Record<string, any>) => string;
 declare const parsePerson: (person: string) => any;
 declare const fixPerson: (data: any) => any;
 declare const fixInterfaces: (meta: any, removeMerged?: boolean) => any;
+declare const fixName: (meta: any) => any;
 export { fixRequired };
 export { fixRepository };
 export { fixFiles };
 export { fixKeywords };
 export { fixPerson };
 export { fixTags };
+export { fixName };
 export { formatPerson };
 export { parsePerson };
 export { fixInterfaces };
@@ -25,6 +27,7 @@ declare const _default: {
     fixKeywords: (data: any) => void;
     fixPerson: (data: any) => any;
     fixTags: (data: any) => void;
+    fixName: (meta: any) => any;
     formatPerson: (person: string | Record<string, any>) => string;
     parsePerson: (person: string) => any;
     fixInterfaces: (meta: any, removeMerged?: boolean) => any;

package/lib/fix.js

@@ -26,7 +26,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.fixService = exports.fixInterfaces = exports.parsePerson = exports.formatPerson = exports.fixTags = exports.fixPerson = exports.fixKeywords = exports.fixFiles = exports.fixRepository = exports.fixRequired = void 0;
+exports.fixService = exports.fixInterfaces = exports.parsePerson = exports.formatPerson = exports.fixName = exports.fixTags = exports.fixPerson = exports.fixKeywords = exports.fixFiles = exports.fixRepository = exports.fixRequired = void 0;
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const get_1 = __importDefault(require("lodash/get"));
@@ -35,6 +35,7 @@ const debug_1 = __importDefault(require("debug"));
 const validate_1 = require("./validate");
 Object.defineProperty(exports, "fixService", { enumerable: true, get: function () { return validate_1.fixAndValidateService; } });
 const constants_1 = __importDefault(require("./constants"));
+const name_1 = require("./name");
 const debug = (0, debug_1.default)('@blocklet/meta:fix');
 const { BLOCKLET_DEFAULT_VERSION, BLOCKLET_DEFAULT_PORT_NAME, BLOCKLET_DYNAMIC_PATH_PREFIX, BLOCKLET_INTERFACE_TYPE_WEB, BLOCKLET_INTERFACE_PUBLIC, } = constants_1.default;
 // Assign sensible defaults: description/main/group/version/public_url
@@ -228,6 +229,18 @@ const fixInterfaces = (meta, removeMerged = true) => {
     return meta;
 };
 exports.fixInterfaces = fixInterfaces;
+const fixName = (meta) => {
+    const { did } = meta;
+    try {
+        (0, name_1.validateNewDid)(did);
+        meta.name = did;
+    }
+    catch (_a) {
+        /* empty */
+    }
+    return meta;
+};
+exports.fixName = fixName;
 exports.default = {
     fixRequired,
     fixRepository,
@@ -235,6 +248,7 @@ exports.default = {
     fixKeywords,
     fixPerson,
     fixTags,
+    fixName,
     formatPerson,
     parsePerson,
     fixInterfaces,

package/lib/index.d.ts

@@ -6,13 +6,14 @@ import getBlockletWallet from './wallet';
 import getBlockletInfo from './info';
 import getBlockletEngine from './engine';
 import { validateMeta, fixAndValidateService } from './validate';
-import { formatPerson, parsePerson, fixPerson, fixInterfaces, fixService } from './fix';
-import { list, select, update } from './file';
+import { formatPerson, parsePerson, fixPerson, fixInterfaces, fixService, fixName } from './fix';
+import { list, select, update, read } from './file';
 import verifyMultiSig from './verify-multi-sig';
 export { constants };
 export { list };
 export { select };
 export { update };
+export { read };
 export { parse };
 export { validateMeta };
 export { fixAndValidateService };
@@ -21,6 +22,7 @@ export { parsePerson };
 export { fixPerson };
 export { fixInterfaces };
 export { fixService };
+export { fixName };
 export { toBlockletDid };
 export { getBlockletWallet };
 export { getBlockletInfo };
@@ -35,6 +37,7 @@ declare const _default: {
     update: (file: string, meta: import("./types").TBlockletMeta, { fix }?: {
         fix?: boolean;
     }) => void;
+    read: (file: string) => unknown;
     parse: (dir: string, { ensureMain, ensureFiles, ensureDist, ensureComponentStore, extraRawAttrs, schemaOptions, defaultStoreUrl, fix, }?: {
         ensureMain?: boolean;
         ensureFiles?: boolean;
@@ -59,6 +62,7 @@ declare const _default: {
     parsePerson: (person: string) => any;
     fixPerson: (data: any) => any;
     fixInterfaces: (meta: any, removeMerged?: boolean) => any;
+    fixName: (meta: any) => any;
     fixService: (meta: import("./types").TBlockletMeta) => import("./types").TBlockletMeta;
     toBlockletDid: {
         (name: string | Buffer): string;

package/lib/index.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.verifyMultiSig = exports.getBlockletEngine = exports.getBlockletInfo = exports.getBlockletWallet = exports.toBlockletDid = exports.fixService = exports.fixInterfaces = exports.fixPerson = exports.parsePerson = exports.formatPerson = exports.fixAndValidateService = exports.validateMeta = exports.parse = exports.update = exports.select = exports.list = exports.constants = void 0;
+exports.verifyMultiSig = exports.getBlockletEngine = exports.getBlockletInfo = exports.getBlockletWallet = exports.toBlockletDid = exports.fixName = exports.fixService = exports.fixInterfaces = exports.fixPerson = exports.parsePerson = exports.formatPerson = exports.fixAndValidateService = exports.validateMeta = exports.parse = exports.read = exports.update = exports.select = exports.list = exports.constants = void 0;
 const constants_1 = __importDefault(require("./constants"));
 exports.constants = constants_1.default;
 const parse_1 = __importDefault(require("./parse"));
@@ -25,10 +25,12 @@ Object.defineProperty(exports, "parsePerson", { enumerable: true, get: function
 Object.defineProperty(exports, "fixPerson", { enumerable: true, get: function () { return fix_1.fixPerson; } });
 Object.defineProperty(exports, "fixInterfaces", { enumerable: true, get: function () { return fix_1.fixInterfaces; } });
 Object.defineProperty(exports, "fixService", { enumerable: true, get: function () { return fix_1.fixService; } });
+Object.defineProperty(exports, "fixName", { enumerable: true, get: function () { return fix_1.fixName; } });
 const file_1 = require("./file");
 Object.defineProperty(exports, "list", { enumerable: true, get: function () { return file_1.list; } });
 Object.defineProperty(exports, "select", { enumerable: true, get: function () { return file_1.select; } });
 Object.defineProperty(exports, "update", { enumerable: true, get: function () { return file_1.update; } });
+Object.defineProperty(exports, "read", { enumerable: true, get: function () { return file_1.read; } });
 const verify_multi_sig_1 = __importDefault(require("./verify-multi-sig"));
 exports.verifyMultiSig = verify_multi_sig_1.default;
 exports.default = {
@@ -36,6 +38,7 @@ exports.default = {
     list: file_1.list,
     select: file_1.select,
     update: file_1.update,
+    read: file_1.read,
     parse: parse_1.default,
     validateMeta: validate_1.validateMeta,
     fixAndValidateService: validate_1.fixAndValidateService,
@@ -43,6 +46,7 @@ exports.default = {
     parsePerson: fix_1.parsePerson,
     fixPerson: fix_1.fixPerson,
     fixInterfaces: fix_1.fixInterfaces,
+    fixName: fix_1.fixName,
     fixService: fix_1.fixService,
     toBlockletDid: did_1.default,
     getBlockletWallet: wallet_1.default,

package/lib/name.d.ts

@@ -1,5 +1,11 @@
+/**
+ * 检查一个 did 是否为新版 blocklet-did（这里只需要判断是否为 ROLE_BLOCKLET 即可）
+ * @param did 需要检查是否为新版 did 的值
+ */
+export declare const validateNewDid: (did: string) => void;
 export declare const validateName: (name: string) => void;
 declare const _default: {
     validateName: (name: string) => void;
+    validateNewDid: (did: string) => void;
 };
 export default _default;

package/lib/name.js

@@ -3,15 +3,39 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.validateName = void 0;
+exports.validateName = exports.validateNewDid = void 0;
+const did_1 = require("@arcblock/did");
 const validate_npm_package_name_1 = __importDefault(require("validate-npm-package-name"));
+const MAX_NAME_LENGTH = 32;
+/**
+ * 检查一个 did 是否为新版 blocklet-did（这里只需要判断是否为 ROLE_BLOCKLET 即可）
+ * @param did 需要检查是否为新版 did 的值
+ */
+const validateNewDid = (did) => {
+    const typeInfo = (0, did_1.toTypeInfo)(did);
+    if (typeInfo.role !== did_1.types.RoleType.ROLE_BLOCKLET) {
+        throw new Error("Blocklet DID's type must be ROLE_BLOCKLET");
+    }
+};
+exports.validateNewDid = validateNewDid;
 const validateName = (name) => {
-    const { validForNewPackages, errors = [], warnings = [] } = (0, validate_npm_package_name_1.default)(name);
-    if (!validForNewPackages) {
-        throw new Error(errors[0] || warnings[0]);
+    if ((0, did_1.isValid)(name)) {
+        // new did mode
+        (0, exports.validateNewDid)(name);
+    }
+    else {
+        // old did mode
+        const { validForNewPackages, errors = [], warnings = [] } = (0, validate_npm_package_name_1.default)(name);
+        if (!validForNewPackages) {
+            throw new Error(errors[0] || warnings[0]);
+        }
+        if (name.length > MAX_NAME_LENGTH) {
+            throw new Error('Blocklet name is too long');
+        }
     }
 };
 exports.validateName = validateName;
 exports.default = {
     validateName: exports.validateName,
+    validateNewDid: exports.validateNewDid,
 };

package/lib/parse.js

@@ -61,6 +61,7 @@ const parse = (dir, { ensureMain = false, ensureFiles = false, ensureDist = fals
     (0, fix_1.fixFiles)(result);
     (0, fix_1.fixKeywords)(result);
     (0, fix_1.fixTags)(result);
+    (0, fix_1.fixName)(result);
     (0, fix_1.fixPerson)(result);
     (0, fix_1.fixService)(result);
     if (defaultStoreUrl && ((_a = result.components) === null || _a === void 0 ? void 0 : _a.length)) {

package/lib/schema.js

@@ -17,13 +17,13 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.authConfigSchema = exports.cacheableSchema = exports.statsSchema = exports.titleSchema = exports.themeSchema = exports.signatureSchema = exports.serviceSchema = exports.scriptsSchema = exports.personSchema = exports.navigationSchema = exports.navigationItemSchema = exports.mountPointSchema = exports.logoSchema = exports.interfaceSchema = exports.environmentNameSchema = exports.environmentSchema = exports.engineSchema = exports.endpointSchema = exports.distSchema = exports.descriptionSchema = exports.createBlockletSchema = exports.componentSchema = exports.blockletNameSchema = exports.blockletMetaSchema = void 0;
 const fs_1 = __importDefault(require("fs"));
 const joi_1 = __importDefault(require("joi"));
-// eslint-disable-next-line import/no-named-default
 const cjk_length_1 = __importDefault(require("cjk-length"));
 const is_glob_1 = __importDefault(require("is-glob"));
 const joi_extension_semver_1 = require("joi-extension-semver");
 const is_var_name_1 = __importDefault(require("is-var-name"));
 const constant_1 = require("@abtnode/constant");
-const did_1 = __importDefault(require("./did"));
+const did_1 = require("@arcblock/did");
+const did_2 = __importDefault(require("./did"));
 const extension_1 = require("./extension");
 const name_1 = require("./name");
 const constants_1 = __importDefault(require("./constants"));
@@ -32,7 +32,6 @@ const cjkLength = cjk_length_1.default.default;
 const { BLOCKLET_GROUPS, BLOCKLET_PLATFORMS, BLOCKLET_ARCHITECTURES, BLOCKLET_INTERFACE_TYPES, BLOCKLET_INTERFACE_PROTOCOLS, BLOCKLET_ENTRY_FILE, BLOCKLET_BUNDLE_FILE, BLOCKLET_DEFAULT_PORT_NAME, BLOCKLET_DYNAMIC_PATH_PREFIX, BlockletGroup, BLOCKLET_LATEST_REQUIREMENT_SERVER, BLOCKLET_INTERFACE_TYPE_WEB, BLOCKLET_INTERFACE_TYPE_WELLKNOWN, BLOCKLET_APP_SPACE_ENDPOINTS, BLOCKLET_CONFIGURABLE_KEY, } = constants_1.default;
 const WELLKNOWN_PATH_PREFIX = '/.well-known';
 const MAX_TITLE_LENGTH = 24;
-const MAX_NAME_LENGTH = 32;
 const Joi = joi_1.default.extend(joi_extension_semver_1.semver)
     .extend(joi_extension_semver_1.semverRange)
     .extend(extension_1.fileExtension)
@@ -95,7 +94,6 @@ const blockletNameSchema = Joi.string()
     (0, name_1.validateName)(value);
     return value;
 })
-    .max(MAX_NAME_LENGTH)
     .meta({ className: 'TBlockletName' });
 exports.blockletNameSchema = blockletNameSchema;
 const ENV_NAME_WHITE_LIST = [BLOCKLET_CONFIGURABLE_KEY.BLOCKLET_WALLET_TYPE];
@@ -425,7 +423,7 @@ exports.authConfigSchema = authConfigSchema;
 const blockletMetaProps = {
     did: Joi.DID().trim().required(),
     version: Joi.semver().valid().required(),
-    name: blockletNameSchema.required(),
+    name: blockletNameSchema.optional(),
     description: descriptionSchema.required(),
     group: Joi.string()
         .valid(...BLOCKLET_GROUPS)
@@ -647,10 +645,29 @@ const createBlockletSchema = (baseDir, _a = {}) => {
         .rename('children', 'components')
         .custom((data, helper) => {
         const { did, name } = data;
-        const expectDid = (0, did_1.default)(name);
-        if (expectDid !== did) {
-            // @ts-expect-error
-            return helper.message(`the did of name "${name}" should be "${expectDid}"`);
+        let cacheError;
+        if ((0, did_1.isValid)(did)) {
+            try {
+                (0, name_1.validateNewDid)(did);
+                return data;
+            }
+            catch (e) {
+                cacheError = e;
+            }
+        }
+        /* ------------- 兼容旧的逻辑，旧逻辑使用 name 生成一个 did ------------- */
+        // 此时 name 必须存在
+        if (name) {
+            const expectDid = (0, did_2.default)(name);
+            if (expectDid !== did) {
+                // @ts-ignore
+                return helper.message(`The did of name "${name}" should be "${expectDid}"`);
+            }
+            return data;
+            /* ------------------------------------------------------ */
+        }
+        if (cacheError) {
+            return helper.message(cacheError.message);
         }
         return data;
     });

package/lib/types/schema.d.ts

@@ -66,7 +66,7 @@ export interface TBlockletMeta {
     logoUrl?: string;
     main: string;
     maintainers?: TPerson[];
-    name: TBlockletName;
+    name?: TBlockletName;
     navigation?: TNavigation;
     nftFactory?: string;
     path?: string;

package/lib/util.d.ts

@@ -54,10 +54,21 @@ declare const forEachBlocklet: (blocklet: BlockletState | ComponentState, cb: Fu
 declare const forEachBlockletSync: (blocklet: any, cb: Function) => Promise<unknown>;
 declare const forEachChild: (blocklet: any, cb: Function, params?: any) => Promise<any>;
 declare const forEachChildSync: (blocklet: BlockletState, cb: Function) => Promise<any>;
-declare const findComponentById: (blocklet: BlockletState | ComponentState, componentId: string | Array<string>, { _ancestors, returnAncestors, }?: {
-    _ancestors?: any[];
+declare const findComponent: (blocklet: BlockletState | ComponentState, isEqualFn: (component: ComponentState, context: {
+    ancestors: Array<ComponentState>;
+}) => boolean, { _ancestors, returnAncestors, }?: {
+    _ancestors?: Array<ComponentState>;
+    returnAncestors?: boolean;
+}) => ComponentState | {
+    component: ComponentState;
+    ancestors: Array<ComponentState>;
+};
+declare const findComponentById: (blocklet: BlockletState | ComponentState, componentId: string | Array<string>, { returnAncestors, }?: {
     returnAncestors?: boolean;
-}) => any;
+}) => ComponentState | {
+    component: ComponentState;
+    ancestors: Array<ComponentState>;
+};
 declare const isEnvShareable: (env?: TConfig) => boolean;
 declare const getSharedConfigObj: (component: BlockletState, ancestors?: any[]) => any;
 declare const isPreferenceKey: (x: TConfig) => Boolean;
@@ -78,6 +89,7 @@ declare const hasRunnableComponent: (blocklet: BlockletState) => boolean;
 declare const getDisplayName: (blocklet: BlockletState, onlyUseMeta?: boolean) => string;
 declare const fixBlockletStatus: (blocklet?: BlockletState) => void;
 declare const findWebInterface: (blocklet?: BlockletState | TBlockletMeta) => any;
+declare const findWebInterfacePort: (blocklet?: BlockletState) => any;
 declare const findServiceFromMeta: (meta?: TBlockletMeta, ServiceName?: string) => any;
 declare const getWhoCanAccess: (blocklet?: BlockletState) => any;
 declare const getConnectAppUrl: ({ request, baseUrl }: {
@@ -108,6 +120,7 @@ export { hasRunnableComponent };
 export { getDisplayName };
 export { fixBlockletStatus };
 export { findWebInterface };
+export { findWebInterfacePort };
 export { findServiceFromMeta };
 export { getWhoCanAccess };
 export { replaceSlotToIp };
@@ -115,6 +128,7 @@ export { urlFriendly };
 export { getComponentId };
 export { getComponentName };
 export { getComponentBundleId };
+export { findComponent };
 export { findComponentById };
 export { getParentComponentName };
 export { getConnectAppUrl };
@@ -151,6 +165,7 @@ declare const _default: {
     getDisplayName: (blocklet: BlockletState, onlyUseMeta?: boolean) => string;
     fixBlockletStatus: (blocklet?: BlockletState) => void;
     findWebInterface: (blocklet?: TBlockletMeta | BlockletState) => any;
+    findWebInterfacePort: (blocklet?: BlockletState) => any;
     findServiceFromMeta: (meta?: TBlockletMeta, ServiceName?: string) => any;
     getWhoCanAccess: (blocklet?: BlockletState) => any;
     replaceSlotToIp: (url?: string, ip?: string) => string;
@@ -179,10 +194,21 @@ declare const _default: {
             version: string;
         };
     }) => string;
-    findComponentById: (blocklet: BlockletState | ComponentState, componentId: string | string[], { _ancestors, returnAncestors, }?: {
-        _ancestors?: any[];
+    findComponent: (blocklet: BlockletState | ComponentState, isEqualFn: (component: ComponentState, context: {
+        ancestors: ComponentState[];
+    }) => boolean, { _ancestors, returnAncestors, }?: {
+        _ancestors?: ComponentState[];
+        returnAncestors?: boolean;
+    }) => ComponentState | {
+        component: ComponentState;
+        ancestors: ComponentState[];
+    };
+    findComponentById: (blocklet: BlockletState | ComponentState, componentId: string | string[], { returnAncestors, }?: {
         returnAncestors?: boolean;
-    }) => any;
+    }) => ComponentState | {
+        component: ComponentState;
+        ancestors: ComponentState[];
+    };
     getParentComponentName: (name?: string) => string;
     getConnectAppUrl: ({ request, baseUrl }: {
         request: Partial<Request<import("express-serve-static-core").ParamsDictionary, any, any, import("qs").ParsedQs, Record<string, any>>>;

package/lib/util.js

@@ -12,7 +12,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getRolesFromAuthConfig = exports.isPreferenceKey = exports.isExternalBlocklet = exports.getChainInfo = exports.getConnectAppUrl = exports.getParentComponentName = exports.findComponentById = exports.getComponentBundleId = exports.getComponentName = exports.getComponentId = exports.urlFriendly = exports.replaceSlotToIp = exports.getWhoCanAccess = exports.findServiceFromMeta = exports.findWebInterface = exports.fixBlockletStatus = exports.getDisplayName = exports.hasRunnableComponent = exports.wipeSensitiveData = exports.isEnvShareable = exports.getComponentMissingConfigs = exports.getAppMissingConfigs = exports.getSharedConfigObj = exports.isDeletableBlocklet = exports.forEachChildSync = exports.forEachChild = exports.forEachBlockletSync = exports.forEachBlocklet = exports.isComponentBlocklet = exports.isFreeComponent = exports.isFreeBlocklet = void 0;
+exports.getRolesFromAuthConfig = exports.isPreferenceKey = exports.isExternalBlocklet = exports.getChainInfo = exports.getConnectAppUrl = exports.getParentComponentName = exports.findComponentById = exports.findComponent = exports.getComponentBundleId = exports.getComponentName = exports.getComponentId = exports.urlFriendly = exports.replaceSlotToIp = exports.getWhoCanAccess = exports.findServiceFromMeta = exports.findWebInterfacePort = exports.findWebInterface = exports.fixBlockletStatus = exports.getDisplayName = exports.hasRunnableComponent = exports.wipeSensitiveData = exports.isEnvShareable = exports.getComponentMissingConfigs = exports.getAppMissingConfigs = exports.getSharedConfigObj = exports.isDeletableBlocklet = exports.forEachChildSync = exports.forEachChild = exports.forEachBlockletSync = exports.forEachBlocklet = exports.isComponentBlocklet = exports.isFreeComponent = exports.isFreeBlocklet = void 0;
 /* eslint-disable no-await-in-loop */
 const get_1 = __importDefault(require("lodash/get"));
 const slugify_1 = __importDefault(require("slugify"));
@@ -153,13 +153,11 @@ exports.forEachChild = forEachChild;
 // eslint-disable-next-line @typescript-eslint/no-unused-vars
 const forEachChildSync = (blocklet, cb) => forEachChild(blocklet, cb, { sync: true });
 exports.forEachChildSync = forEachChildSync;
-const findComponentById = (blocklet, componentId, { _ancestors = [], returnAncestors = false, } = {}) => {
-    if (Array.isArray(componentId)) {
-        // eslint-disable-next-line no-param-reassign
-        componentId = componentId.join('/');
+const findComponent = (blocklet, isEqualFn, { _ancestors = [], returnAncestors = false, } = {}) => {
+    if (!isEqualFn) {
+        return null;
     }
-    const id = getComponentId(blocklet, _ancestors);
-    if (componentId === id) {
+    if (isEqualFn(blocklet, { ancestors: _ancestors })) {
         if (returnAncestors) {
             return {
                 component: blocklet,
@@ -170,13 +168,24 @@ const findComponentById = (blocklet, componentId, { _ancestors = [], returnAnces
     }
     for (const child of blocklet.children || []) {
         const ancestors = _ancestors.concat(blocklet);
-        const component = findComponentById(child, componentId, { _ancestors: ancestors, returnAncestors });
+        const component = findComponent(child, isEqualFn, { _ancestors: ancestors, returnAncestors });
         if (component) {
             return component;
         }
     }
     return null;
 };
+exports.findComponent = findComponent;
+const findComponentById = (blocklet, componentId, { returnAncestors = false, } = {}) => {
+    if (Array.isArray(componentId)) {
+        // eslint-disable-next-line no-param-reassign
+        componentId = componentId.join('/');
+    }
+    return findComponent(blocklet, (component, { ancestors }) => {
+        const id = getComponentId(component, ancestors);
+        return componentId === id;
+    }, { returnAncestors });
+};
 exports.findComponentById = findComponentById;
 const isEnvShareable = (env) => {
     return (!!env &&
@@ -365,6 +374,18 @@ const findWebInterface = (blocklet) => {
     return interfaces.find((x) => x.type === BLOCKLET_INTERFACE_TYPE_WEB);
 };
 exports.findWebInterface = findWebInterface;
+const findWebInterfacePort = (blocklet) => {
+    if (!blocklet) {
+        return null;
+    }
+    const webInterface = findWebInterface(blocklet);
+    const { ports } = blocklet;
+    if (!webInterface || !ports) {
+        return null;
+    }
+    return ports[webInterface.port];
+};
+exports.findWebInterfacePort = findWebInterfacePort;
 const findServiceFromMeta = (meta, ServiceName) => {
     const names = [ServiceName];
     // backward compatible
@@ -445,6 +466,7 @@ exports.default = {
     getDisplayName,
     fixBlockletStatus,
     findWebInterface,
+    findWebInterfacePort,
     findServiceFromMeta,
     getWhoCanAccess,
     replaceSlotToIp,
@@ -452,6 +474,7 @@ exports.default = {
     getComponentId,
     getComponentName,
     getComponentBundleId,
+    findComponent,
     findComponentById,
     getParentComponentName,
     getConnectAppUrl,

package/package.json

@@ -3,7 +3,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "1.8.65",
+  "version": "1.8.66-beta-7f4224af",
   "description": "Library to parse/validate/fix blocklet meta",
   "main": "./lib/index.js",
   "typings": "./lib/index.d.ts",
@@ -24,19 +24,19 @@
   "author": "wangshijun <wangshijun2020@gmail.com> (http://github.com/wangshijun)",
   "license": "MIT",
   "dependencies": {
-    "@abtnode/client": "1.8.65",
-    "@abtnode/constant": "1.8.65",
-    "@abtnode/util": "1.8.65",
-    "@arcblock/did": "1.18.42",
-    "@arcblock/did-ext": "1.18.42",
-    "@arcblock/did-util": "1.18.42",
-    "@arcblock/jwt": "1.18.42",
-    "@blocklet/constant": "1.8.65",
-    "@ocap/asset": "1.18.42",
-    "@ocap/mcrypto": "1.18.42",
-    "@ocap/types": "1.18.42",
-    "@ocap/util": "1.18.42",
-    "@ocap/wallet": "1.18.42",
+    "@abtnode/client": "1.8.66-beta-7f4224af",
+    "@abtnode/constant": "1.8.66-beta-7f4224af",
+    "@abtnode/util": "1.8.66-beta-7f4224af",
+    "@arcblock/did": "1.18.47",
+    "@arcblock/did-ext": "1.18.47",
+    "@arcblock/did-util": "1.18.47",
+    "@arcblock/jwt": "1.18.47",
+    "@blocklet/constant": "1.8.66-beta-7f4224af",
+    "@ocap/asset": "1.18.47",
+    "@ocap/mcrypto": "1.18.47",
+    "@ocap/types": "1.18.47",
+    "@ocap/util": "1.18.47",
+    "@ocap/wallet": "1.18.47",
     "ajv": "^8.11.0",
     "axios": "^0.27.2",
     "cjk-length": "^1.0.0",
@@ -59,7 +59,7 @@
     "validate-npm-package-name": "^3.0.0"
   },
   "devDependencies": {
-    "@abtnode/client": "^1.8.64",
+    "@abtnode/client": "^1.8.65",
     "@arcblock/eslint-config-ts": "^0.2.3",
     "@types/express": "^4.17.14",
     "@types/jest": "^29.2.2",
@@ -80,5 +80,5 @@
     "ts-node": "^10.9.1",
     "typescript": "^4.8.4"
   },
-  "gitHead": "69b608353fbbdb7c61f9ccb10965a1d0c55c45f2"
+  "gitHead": "72d418f63ecb76b1d5d62edbcc5f336cb62bf308"
 }