@metamask/snaps-controllers 1.0.2 → 2.0.0

package/dist/esm/snaps/registry/json.js

@@ -0,0 +1,267 @@
+function _check_private_redeclaration(obj, privateCollection) {
+    if (privateCollection.has(obj)) {
+        throw new TypeError("Cannot initialize the same private elements twice on an object");
+    }
+}
+function _class_apply_descriptor_get(receiver, descriptor) {
+    if (descriptor.get) {
+        return descriptor.get.call(receiver);
+    }
+    return descriptor.value;
+}
+function _class_apply_descriptor_set(receiver, descriptor, value) {
+    if (descriptor.set) {
+        descriptor.set.call(receiver, value);
+    } else {
+        if (!descriptor.writable) {
+            throw new TypeError("attempted to set read only private field");
+        }
+        descriptor.value = value;
+    }
+}
+function _class_extract_field_descriptor(receiver, privateMap, action) {
+    if (!privateMap.has(receiver)) {
+        throw new TypeError("attempted to " + action + " private field on non-instance");
+    }
+    return privateMap.get(receiver);
+}
+function _class_private_field_get(receiver, privateMap) {
+    var descriptor = _class_extract_field_descriptor(receiver, privateMap, "get");
+    return _class_apply_descriptor_get(receiver, descriptor);
+}
+function _class_private_field_init(obj, privateMap, value) {
+    _check_private_redeclaration(obj, privateMap);
+    privateMap.set(obj, value);
+}
+function _class_private_field_set(receiver, privateMap, value) {
+    var descriptor = _class_extract_field_descriptor(receiver, privateMap, "set");
+    _class_apply_descriptor_set(receiver, descriptor, value);
+    return value;
+}
+function _class_private_method_get(receiver, privateSet, fn) {
+    if (!privateSet.has(receiver)) {
+        throw new TypeError("attempted to get private field on non-instance");
+    }
+    return fn;
+}
+function _class_private_method_init(obj, privateSet) {
+    _check_private_redeclaration(obj, privateSet);
+    privateSet.add(obj);
+}
+import { BaseControllerV2 as BaseController } from '@metamask/base-controller';
+import { verify } from '@metamask/snaps-registry';
+import { assert, Duration, inMilliseconds, satisfiesVersionRange } from '@metamask/utils';
+import { SnapsRegistryStatus } from './registry';
+// TODO: Replace with a Codefi URL
+const SNAP_REGISTRY_URL = 'https://cdn.jsdelivr.net/gh/MetaMask/snaps-registry@gh-pages/latest/registry.json';
+const SNAP_REGISTRY_SIGNATURE_URL = 'https://cdn.jsdelivr.net/gh/MetaMask/snaps-registry@gh-pages/latest/signature.json';
+const controllerName = 'SnapsRegistry';
+const defaultState = {
+    database: null,
+    lastUpdated: null
+};
+var _url = /*#__PURE__*/ new WeakMap(), _publicKey = /*#__PURE__*/ new WeakMap(), _fetchFunction = /*#__PURE__*/ new WeakMap(), _recentFetchThreshold = /*#__PURE__*/ new WeakMap(), _refetchOnAllowlistMiss = /*#__PURE__*/ new WeakMap(), _failOnUnavailableRegistry = /*#__PURE__*/ new WeakMap(), _currentUpdate = /*#__PURE__*/ new WeakMap(), _wasRecentlyFetched = /*#__PURE__*/ new WeakSet(), _triggerUpdate = /*#__PURE__*/ new WeakSet(), _update = /*#__PURE__*/ new WeakSet(), _getDatabase = /*#__PURE__*/ new WeakSet(), _getSingle = /*#__PURE__*/ new WeakSet(), _get = /*#__PURE__*/ new WeakSet(), _getMetadata = /*#__PURE__*/ new WeakSet(), _verifySignature = /*#__PURE__*/ new WeakSet(), _safeFetch = /*#__PURE__*/ new WeakSet();
+export class JsonSnapsRegistry extends BaseController {
+    constructor({ messenger, state, url = {
+        registry: SNAP_REGISTRY_URL,
+        signature: SNAP_REGISTRY_SIGNATURE_URL
+    }, publicKey, fetchFunction = globalThis.fetch.bind(globalThis), recentFetchThreshold = inMilliseconds(5, Duration.Minute), failOnUnavailableRegistry = true, refetchOnAllowlistMiss = true }){
+        super({
+            messenger,
+            metadata: {
+                database: {
+                    persist: true,
+                    anonymous: false
+                },
+                lastUpdated: {
+                    persist: true,
+                    anonymous: false
+                }
+            },
+            name: controllerName,
+            state: {
+                ...defaultState,
+                ...state
+            }
+        });
+        _class_private_method_init(this, _wasRecentlyFetched);
+        /**
+   * Triggers an update of the registry database.
+   *
+   * If an existing update is in progress this function will await that update.
+   */ _class_private_method_init(this, _triggerUpdate);
+        /**
+   * Updates the registry database if the registry hasn't been updated recently.
+   *
+   * NOTE: SHOULD NOT be called directly, instead `triggerUpdate` should be used.
+   */ _class_private_method_init(this, _update);
+        _class_private_method_init(this, _getDatabase);
+        _class_private_method_init(this, _getSingle);
+        _class_private_method_init(this, _get);
+        /**
+   * Get metadata for the given snap ID.
+   *
+   * @param snapId - The ID of the snap to get metadata for.
+   * @returns The metadata for the given snap ID, or `null` if the snap is not
+   * verified.
+   */ _class_private_method_init(this, _getMetadata);
+        /**
+   * Verify the signature of the registry.
+   *
+   * @param database - The registry database.
+   * @param signature - The signature of the registry.
+   * @throws If the signature is invalid.
+   * @private
+   */ _class_private_method_init(this, _verifySignature);
+        /**
+   * Fetch the given URL, throwing if the response is not OK.
+   *
+   * @param url - The URL to fetch.
+   * @returns The response body.
+   * @private
+   */ _class_private_method_init(this, _safeFetch);
+        _class_private_field_init(this, _url, {
+            writable: true,
+            value: void 0
+        });
+        _class_private_field_init(this, _publicKey, {
+            writable: true,
+            value: void 0
+        });
+        _class_private_field_init(this, _fetchFunction, {
+            writable: true,
+            value: void 0
+        });
+        _class_private_field_init(this, _recentFetchThreshold, {
+            writable: true,
+            value: void 0
+        });
+        _class_private_field_init(this, _refetchOnAllowlistMiss, {
+            writable: true,
+            value: void 0
+        });
+        _class_private_field_init(this, _failOnUnavailableRegistry, {
+            writable: true,
+            value: void 0
+        });
+        _class_private_field_init(this, _currentUpdate, {
+            writable: true,
+            value: void 0
+        });
+        _class_private_field_set(this, _url, url);
+        _class_private_field_set(this, _publicKey, publicKey);
+        _class_private_field_set(this, _fetchFunction, fetchFunction);
+        _class_private_field_set(this, _recentFetchThreshold, recentFetchThreshold);
+        _class_private_field_set(this, _refetchOnAllowlistMiss, refetchOnAllowlistMiss);
+        _class_private_field_set(this, _failOnUnavailableRegistry, failOnUnavailableRegistry);
+        _class_private_field_set(this, _currentUpdate, null);
+        this.messagingSystem.registerActionHandler('SnapsRegistry:get', async (...args)=>_class_private_method_get(this, _get, get).call(this, ...args));
+        this.messagingSystem.registerActionHandler('SnapsRegistry:getMetadata', async (...args)=>_class_private_method_get(this, _getMetadata, getMetadata).call(this, ...args));
+        this.messagingSystem.registerActionHandler('SnapsRegistry:update', async ()=>_class_private_method_get(this, _triggerUpdate, triggerUpdate).call(this));
+    }
+}
+function wasRecentlyFetched() {
+    return this.state.lastUpdated && Date.now() - this.state.lastUpdated < _class_private_field_get(this, _recentFetchThreshold);
+}
+async function triggerUpdate() {
+    // If an update is ongoing, wait for that.
+    if (_class_private_field_get(this, _currentUpdate)) {
+        await _class_private_field_get(this, _currentUpdate);
+        return;
+    }
+    // If no update exists, create promise and store globally.
+    if (_class_private_field_get(this, _currentUpdate) === null) {
+        _class_private_field_set(this, _currentUpdate, _class_private_method_get(this, _update, update).call(this));
+    }
+    await _class_private_field_get(this, _currentUpdate);
+    _class_private_field_set(this, _currentUpdate, null);
+}
+async function update() {
+    // No-op if we recently fetched the registry.
+    if (_class_private_method_get(this, _wasRecentlyFetched, wasRecentlyFetched).call(this)) {
+        return;
+    }
+    try {
+        const database = await _class_private_method_get(this, _safeFetch, safeFetch).call(this, _class_private_field_get(this, _url).registry);
+        if (_class_private_field_get(this, _publicKey)) {
+            const signature = await _class_private_method_get(this, _safeFetch, safeFetch).call(this, _class_private_field_get(this, _url).signature);
+            await _class_private_method_get(this, _verifySignature, verifySignature).call(this, database, signature);
+        }
+        this.update((state)=>{
+            state.database = JSON.parse(database);
+            state.lastUpdated = Date.now();
+        });
+    } catch  {
+    // Ignore
+    }
+}
+async function getDatabase() {
+    if (this.state.database === null) {
+        await _class_private_method_get(this, _triggerUpdate, triggerUpdate).call(this);
+    }
+    // If the database is still null and we require it, throw.
+    if (_class_private_field_get(this, _failOnUnavailableRegistry) && this.state.database === null) {
+        throw new Error('Snaps registry is unavailable, installation blocked.');
+    }
+    return this.state.database;
+}
+async function getSingle(snapId, snapInfo, refetch = false) {
+    const database = await _class_private_method_get(this, _getDatabase, getDatabase).call(this);
+    const blockedEntry = database?.blockedSnaps.find((blocked)=>{
+        if ('id' in blocked) {
+            return blocked.id === snapId && satisfiesVersionRange(snapInfo.version, blocked.versionRange);
+        }
+        return blocked.checksum === snapInfo.checksum;
+    });
+    if (blockedEntry) {
+        return {
+            status: SnapsRegistryStatus.Blocked,
+            reason: blockedEntry.reason
+        };
+    }
+    const verified = database?.verifiedSnaps[snapId];
+    const version = verified?.versions?.[snapInfo.version];
+    if (version && version.checksum === snapInfo.checksum) {
+        return {
+            status: SnapsRegistryStatus.Verified
+        };
+    }
+    // For now, if we have an allowlist miss, we can refetch once and try again.
+    if (_class_private_field_get(this, _refetchOnAllowlistMiss) && !refetch) {
+        await _class_private_method_get(this, _triggerUpdate, triggerUpdate).call(this);
+        return _class_private_method_get(this, _getSingle, getSingle).call(this, snapId, snapInfo, true);
+    }
+    return {
+        status: SnapsRegistryStatus.Unverified
+    };
+}
+async function get(snaps) {
+    return Object.entries(snaps).reduce(async (previousPromise, [snapId, snapInfo])=>{
+        const result = await _class_private_method_get(this, _getSingle, getSingle).call(this, snapId, snapInfo);
+        const acc = await previousPromise;
+        acc[snapId] = result;
+        return acc;
+    }, Promise.resolve({}));
+}
+async function getMetadata(snapId) {
+    const database = await _class_private_method_get(this, _getDatabase, getDatabase).call(this);
+    return database?.verifiedSnaps[snapId]?.metadata ?? null;
+}
+async function verifySignature(database, signature) {
+    assert(_class_private_field_get(this, _publicKey), 'No public key provided.');
+    const valid = await verify({
+        registry: database,
+        signature: JSON.parse(signature),
+        publicKey: _class_private_field_get(this, _publicKey)
+    });
+    assert(valid, 'Invalid registry signature.');
+}
+async function safeFetch(url) {
+    const response = await _class_private_field_get(this, _fetchFunction).call(this, url);
+    if (!response.ok) {
+        throw new Error(`Failed to fetch ${url}.`);
+    }
+    return await response.text();
+}
+
+//# sourceMappingURL=json.js.map

package/dist/esm/snaps/registry/json.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/snaps/registry/json.ts"],"sourcesContent":["import type { RestrictedControllerMessenger } from '@metamask/base-controller';\nimport { BaseControllerV2 as BaseController } from '@metamask/base-controller';\nimport type { SnapsRegistryDatabase } from '@metamask/snaps-registry';\nimport { verify } from '@metamask/snaps-registry';\nimport type { SnapId } from '@metamask/snaps-utils';\nimport type { Hex } from '@metamask/utils';\nimport {\n  assert,\n  Duration,\n  inMilliseconds,\n  satisfiesVersionRange,\n} from '@metamask/utils';\n\nimport type {\n  SnapsRegistry,\n  SnapsRegistryInfo,\n  SnapsRegistryMetadata,\n  SnapsRegistryRequest,\n  SnapsRegistryResult,\n} from './registry';\nimport { SnapsRegistryStatus } from './registry';\n\n// TODO: Replace with a Codefi URL\nconst SNAP_REGISTRY_URL =\n  'https://cdn.jsdelivr.net/gh/MetaMask/snaps-registry@gh-pages/latest/registry.json';\n\nconst SNAP_REGISTRY_SIGNATURE_URL =\n  'https://cdn.jsdelivr.net/gh/MetaMask/snaps-registry@gh-pages/latest/signature.json';\n\ntype JsonSnapsRegistryUrl = {\n  registry: string;\n  signature: string;\n};\n\nexport type JsonSnapsRegistryArgs = {\n  messenger: SnapsRegistryMessenger;\n  state?: SnapsRegistryState;\n  fetchFunction?: typeof fetch;\n  url?: JsonSnapsRegistryUrl;\n  recentFetchThreshold?: number;\n  refetchOnAllowlistMiss?: boolean;\n  failOnUnavailableRegistry?: boolean;\n  publicKey?: Hex;\n};\n\nexport type GetResult = {\n  type: `${typeof controllerName}:get`;\n  handler: SnapsRegistry['get'];\n};\n\nexport type GetMetadata = {\n  type: `${typeof controllerName}:getMetadata`;\n  handler: SnapsRegistry['getMetadata'];\n};\n\nexport type Update = {\n  type: `${typeof controllerName}:update`;\n  handler: SnapsRegistry['update'];\n};\n\nexport type SnapsRegistryActions = GetResult | GetMetadata | Update;\n\nexport type SnapsRegistryEvents = never;\n\nexport type SnapsRegistryMessenger = RestrictedControllerMessenger<\n  'SnapsRegistry',\n  SnapsRegistryActions,\n  SnapsRegistryEvents,\n  SnapsRegistryActions['type'],\n  SnapsRegistryEvents['type']\n>;\n\nexport type SnapsRegistryState = {\n  database: SnapsRegistryDatabase | null;\n  lastUpdated: number | null;\n};\n\nconst controllerName = 'SnapsRegistry';\n\nconst defaultState = {\n  database: null,\n  lastUpdated: null,\n};\n\nexport class JsonSnapsRegistry extends BaseController<\n  typeof controllerName,\n  SnapsRegistryState,\n  SnapsRegistryMessenger\n> {\n  #url: JsonSnapsRegistryUrl;\n\n  #publicKey?: Hex;\n\n  #fetchFunction: typeof fetch;\n\n  #recentFetchThreshold: number;\n\n  #refetchOnAllowlistMiss: boolean;\n\n  #failOnUnavailableRegistry: boolean;\n\n  #currentUpdate: Promise<void> | null;\n\n  constructor({\n    messenger,\n    state,\n    url = {\n      registry: SNAP_REGISTRY_URL,\n      signature: SNAP_REGISTRY_SIGNATURE_URL,\n    },\n    publicKey,\n    fetchFunction = globalThis.fetch.bind(globalThis),\n    recentFetchThreshold = inMilliseconds(5, Duration.Minute),\n    failOnUnavailableRegistry = true,\n    refetchOnAllowlistMiss = true,\n  }: JsonSnapsRegistryArgs) {\n    super({\n      messenger,\n      metadata: {\n        database: { persist: true, anonymous: false },\n        lastUpdated: { persist: true, anonymous: false },\n      },\n      name: controllerName,\n      state: {\n        ...defaultState,\n        ...state,\n      },\n    });\n    this.#url = url;\n    this.#publicKey = publicKey;\n    this.#fetchFunction = fetchFunction;\n    this.#recentFetchThreshold = recentFetchThreshold;\n    this.#refetchOnAllowlistMiss = refetchOnAllowlistMiss;\n    this.#failOnUnavailableRegistry = failOnUnavailableRegistry;\n    this.#currentUpdate = null;\n\n    this.messagingSystem.registerActionHandler(\n      'SnapsRegistry:get',\n      async (...args) => this.#get(...args),\n    );\n    this.messagingSystem.registerActionHandler(\n      'SnapsRegistry:getMetadata',\n      async (...args) => this.#getMetadata(...args),\n    );\n\n    this.messagingSystem.registerActionHandler(\n      'SnapsRegistry:update',\n      async () => this.#triggerUpdate(),\n    );\n  }\n\n  #wasRecentlyFetched() {\n    return (\n      this.state.lastUpdated &&\n      Date.now() - this.state.lastUpdated < this.#recentFetchThreshold\n    );\n  }\n\n  /**\n   * Triggers an update of the registry database.\n   *\n   * If an existing update is in progress this function will await that update.\n   */\n  async #triggerUpdate() {\n    // If an update is ongoing, wait for that.\n    if (this.#currentUpdate) {\n      await this.#currentUpdate;\n      return;\n    }\n    // If no update exists, create promise and store globally.\n    if (this.#currentUpdate === null) {\n      this.#currentUpdate = this.#update();\n    }\n    await this.#currentUpdate;\n    this.#currentUpdate = null;\n  }\n\n  /**\n   * Updates the registry database if the registry hasn't been updated recently.\n   *\n   * NOTE: SHOULD NOT be called directly, instead `triggerUpdate` should be used.\n   */\n  async #update() {\n    // No-op if we recently fetched the registry.\n    if (this.#wasRecentlyFetched()) {\n      return;\n    }\n\n    try {\n      const database = await this.#safeFetch(this.#url.registry);\n\n      if (this.#publicKey) {\n        const signature = await this.#safeFetch(this.#url.signature);\n        await this.#verifySignature(database, signature);\n      }\n\n      this.update((state) => {\n        state.database = JSON.parse(database);\n        state.lastUpdated = Date.now();\n      });\n    } catch {\n      // Ignore\n    }\n  }\n\n  async #getDatabase(): Promise<SnapsRegistryDatabase | null> {\n    if (this.state.database === null) {\n      await this.#triggerUpdate();\n    }\n\n    // If the database is still null and we require it, throw.\n    if (this.#failOnUnavailableRegistry && this.state.database === null) {\n      throw new Error('Snaps registry is unavailable, installation blocked.');\n    }\n    return this.state.database;\n  }\n\n  async #getSingle(\n    snapId: SnapId,\n    snapInfo: SnapsRegistryInfo,\n    refetch = false,\n  ): Promise<SnapsRegistryResult> {\n    const database = await this.#getDatabase();\n\n    const blockedEntry = database?.blockedSnaps.find((blocked) => {\n      if ('id' in blocked) {\n        return (\n          blocked.id === snapId &&\n          satisfiesVersionRange(snapInfo.version, blocked.versionRange)\n        );\n      }\n\n      return blocked.checksum === snapInfo.checksum;\n    });\n\n    if (blockedEntry) {\n      return {\n        status: SnapsRegistryStatus.Blocked,\n        reason: blockedEntry.reason,\n      };\n    }\n\n    const verified = database?.verifiedSnaps[snapId];\n    const version = verified?.versions?.[snapInfo.version];\n    if (version && version.checksum === snapInfo.checksum) {\n      return { status: SnapsRegistryStatus.Verified };\n    }\n    // For now, if we have an allowlist miss, we can refetch once and try again.\n    if (this.#refetchOnAllowlistMiss && !refetch) {\n      await this.#triggerUpdate();\n      return this.#getSingle(snapId, snapInfo, true);\n    }\n    return { status: SnapsRegistryStatus.Unverified };\n  }\n\n  async #get(\n    snaps: SnapsRegistryRequest,\n  ): Promise<Record<SnapId, SnapsRegistryResult>> {\n    return Object.entries(snaps).reduce<\n      Promise<Record<SnapId, SnapsRegistryResult>>\n    >(async (previousPromise, [snapId, snapInfo]) => {\n      const result = await this.#getSingle(snapId, snapInfo);\n      const acc = await previousPromise;\n      acc[snapId] = result;\n      return acc;\n    }, Promise.resolve({}));\n  }\n\n  /**\n   * Get metadata for the given snap ID.\n   *\n   * @param snapId - The ID of the snap to get metadata for.\n   * @returns The metadata for the given snap ID, or `null` if the snap is not\n   * verified.\n   */\n  async #getMetadata(snapId: SnapId): Promise<SnapsRegistryMetadata | null> {\n    const database = await this.#getDatabase();\n    return database?.verifiedSnaps[snapId]?.metadata ?? null;\n  }\n\n  /**\n   * Verify the signature of the registry.\n   *\n   * @param database - The registry database.\n   * @param signature - The signature of the registry.\n   * @throws If the signature is invalid.\n   * @private\n   */\n  async #verifySignature(database: string, signature: string) {\n    assert(this.#publicKey, 'No public key provided.');\n\n    const valid = await verify({\n      registry: database,\n      signature: JSON.parse(signature),\n      publicKey: this.#publicKey,\n    });\n\n    assert(valid, 'Invalid registry signature.');\n  }\n\n  /**\n   * Fetch the given URL, throwing if the response is not OK.\n   *\n   * @param url - The URL to fetch.\n   * @returns The response body.\n   * @private\n   */\n  async #safeFetch(url: string) {\n    const response = await this.#fetchFunction(url);\n    if (!response.ok) {\n      throw new Error(`Failed to fetch ${url}.`);\n    }\n\n    return await response.text();\n  }\n}\n"],"names":["BaseControllerV2","BaseController","verify","assert","Duration","inMilliseconds","satisfiesVersionRange","SnapsRegistryStatus","SNAP_REGISTRY_URL","SNAP_REGISTRY_SIGNATURE_URL","controllerName","defaultState","database","lastUpdated","JsonSnapsRegistry","constructor","messenger","state","url","registry","signature","publicKey","fetchFunction","globalThis","fetch","bind","recentFetchThreshold","Minute","failOnUnavailableRegistry","refetchOnAllowlistMiss","metadata","persist","anonymous","name","currentUpdate","messagingSystem","registerActionHandler","args","get","getMetadata","triggerUpdate","Date","now","update","wasRecentlyFetched","safeFetch","verifySignature","JSON","parse","Error","snapId","snapInfo","refetch","getDatabase","blockedEntry","blockedSnaps","find","blocked","id","version","versionRange","checksum","status","Blocked","reason","verified","verifiedSnaps","versions","Verified","getSingle","Unverified","snaps","Object","entries","reduce","previousPromise","result","acc","Promise","resolve","valid","response","ok","text"],"mappings":"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"}

package/dist/esm/snaps/registry/registry.js

@@ -0,0 +1,8 @@
+export var SnapsRegistryStatus;
+(function(SnapsRegistryStatus) {
+    SnapsRegistryStatus[SnapsRegistryStatus["Unverified"] = 0] = "Unverified";
+    SnapsRegistryStatus[SnapsRegistryStatus["Blocked"] = 1] = "Blocked";
+    SnapsRegistryStatus[SnapsRegistryStatus["Verified"] = 2] = "Verified";
+})(SnapsRegistryStatus || (SnapsRegistryStatus = {}));
+
+//# sourceMappingURL=registry.js.map

package/dist/esm/snaps/registry/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/snaps/registry/registry.ts"],"sourcesContent":["import type {\n  BlockReason,\n  SnapsRegistryDatabase,\n} from '@metamask/snaps-registry';\nimport type { SnapId, ValidatedSnapId } from '@metamask/snaps-utils';\nimport type { SemVerVersion } from '@metamask/utils';\n\nexport type SnapsRegistryInfo = { version: SemVerVersion; checksum: string };\nexport type SnapsRegistryRequest = Record<SnapId, SnapsRegistryInfo>;\nexport type SnapsRegistryMetadata =\n  SnapsRegistryDatabase['verifiedSnaps'][ValidatedSnapId]['metadata'];\n\n// TODO: Decide on names for these\nexport enum SnapsRegistryStatus {\n  Unverified = 0,\n  Blocked = 1,\n  Verified = 2,\n}\n\nexport type SnapsRegistryResult = {\n  status: SnapsRegistryStatus;\n  reason?: BlockReason;\n};\n\nexport type SnapsRegistry = {\n  get(\n    snaps: SnapsRegistryRequest,\n  ): Promise<Record<ValidatedSnapId, SnapsRegistryResult>>;\n\n  update(): Promise<void>;\n\n  /**\n   * Get metadata for the given snap ID.\n   *\n   * @param snapId - The ID of the snap to get metadata for.\n   * @returns The metadata for the given snap ID, or `null` if the snap is not\n   * verified.\n   */\n  getMetadata(snapId: SnapId): Promise<SnapsRegistryMetadata | null>;\n};\n"],"names":["SnapsRegistryStatus","Unverified","Blocked","Verified"],"mappings":"WAaO;UAAKA,mBAAmB;IAAnBA,oBAAAA,oBACVC,gBAAa,KAAbA;IADUD,oBAAAA,oBAEVE,aAAU,KAAVA;IAFUF,oBAAAA,oBAGVG,cAAW,KAAXA;GAHUH,wBAAAA"}

package/dist/esm/snaps/selectors.js

@@ -0,0 +1,3 @@
+export const getRunnableSnaps = (snaps)=>snaps.filter((snap)=>snap.enabled && !snap.blocked);
+
+//# sourceMappingURL=selectors.js.map

package/dist/esm/snaps/selectors.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/snaps/selectors.ts"],"sourcesContent":["import type { TruncatedSnap } from '@metamask/snaps-utils';\n\nexport const getRunnableSnaps = <Snap extends TruncatedSnap>(snaps: Snap[]) =>\n  snaps.filter((snap) => snap.enabled && !snap.blocked);\n"],"names":["getRunnableSnaps","snaps","filter","snap","enabled","blocked"],"mappings":"AAEA,OAAO,MAAMA,mBAAmB,CAA6BC,QAC3DA,MAAMC,MAAM,CAAC,CAACC,OAASA,KAAKC,OAAO,IAAI,CAACD,KAAKE,OAAO,EAAE"}

package/dist/{utils.js → esm/utils.js}

@@ -1,7 +1,4 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.withTimeout = exports.hasTimedOut = exports.delayWithTimer = exports.delay = exports.setDiff = void 0;
-const Timer_1 = require("./snaps/Timer");
+import { Timer } from './snaps/Timer';
 /**
  * Takes two objects and does a Set Difference of them.
  * Set Difference is generally defined as follows:
@@ -15,28 +12,24 @@ const Timer_1 = require("./snaps/Timer");
  * @param objectA - The object on which the difference is being calculated.
  * @param objectB - The object whose properties will be removed from objectA.
  * @returns The objectA without properties from objectB.
- */
-function setDiff(objectA, objectB) {
-    return Object.entries(objectA).reduce((acc, [key, value]) => {
+ */ export function setDiff(objectA, objectB) {
+    return Object.entries(objectA).reduce((acc, [key, value])=>{
         if (!(key in objectB)) {
             acc[key] = value;
         }
         return acc;
     }, {});
 }
-exports.setDiff = setDiff;
 /**
- * A Promise that delays it's return for a given amount of milliseconds.
+ * A Promise that delays its return for a given amount of milliseconds.
  *
  * @param ms - Milliseconds to delay the execution for.
  * @param result - The result to return from the Promise after delay.
  * @returns A promise that is void if no result provided, result otherwise.
  * @template Result - The `result`.
- */
-function delay(ms, result) {
-    return delayWithTimer(new Timer_1.Timer(ms), result);
+ */ export function delay(ms, result) {
+    return delayWithTimer(new Timer(ms), result);
 }
-exports.delay = delay;
 /**
  * A Promise that delays it's return by using a pausable Timer.
  *
@@ -44,16 +37,15 @@ exports.delay = delay;
  * @param result - The result to return from the Promise after delay.
  * @returns A promise that is void if no result provided, result otherwise.
  * @template Result - The `result`.
- */
-function delayWithTimer(timer, result) {
+ */ export function delayWithTimer(timer, result) {
     let rejectFunc;
-    const promise = new Promise((resolve, reject) => {
-        timer.start(() => {
+    const promise = new Promise((resolve, reject)=>{
+        timer.start(()=>{
             result === undefined ? resolve() : resolve(result);
         });
         rejectFunc = reject;
     });
-    promise.cancel = () => {
+    promise.cancel = ()=>{
         if (timer.status !== 'finished') {
             timer.cancel();
             rejectFunc(new Error('The delay has been canceled.'));
@@ -61,12 +53,10 @@ function delayWithTimer(timer, result) {
     };
     return promise;
 }
-exports.delayWithTimer = delayWithTimer;
 /*
  * We use a Symbol instead of rejecting the promise so that Errors thrown
  * by the main promise will propagate.
- */
-exports.hasTimedOut = Symbol('Used to check if the requested promise has timeout (see withTimeout)');
+ */ export const hasTimedOut = Symbol('Used to check if the requested promise has timeout (see withTimeout)');
 /**
  * Executes the given Promise, if the Timer expires before the Promise settles, we return earlier.
  *
@@ -76,17 +66,18 @@ exports.hasTimedOut = Symbol('Used to check if the requested promise has timeout
  * @param timerOrMs - The timer controlling the timeout or a ms value.
  * @returns The resolved `PromiseValue`, or the hasTimedOut symbol if
  * returning early.
- * @template PromiseValue- - The value of the Promise.
- */
-async function withTimeout(promise, timerOrMs) {
-    const timer = typeof timerOrMs === 'number' ? new Timer_1.Timer(timerOrMs) : timerOrMs;
-    const delayPromise = delayWithTimer(timer, exports.hasTimedOut);
+ * @template PromiseValue - The value of the Promise.
+ */ export async function withTimeout(promise, timerOrMs) {
+    const timer = typeof timerOrMs === 'number' ? new Timer(timerOrMs) : timerOrMs;
+    const delayPromise = delayWithTimer(timer, hasTimedOut);
     try {
-        return await Promise.race([promise, delayPromise]);
-    }
-    finally {
+        return await Promise.race([
+            promise,
+            delayPromise
+        ]);
+    } finally{
         delayPromise.cancel();
     }
 }
-exports.withTimeout = withTimeout;
+
 //# sourceMappingURL=utils.js.map

package/dist/esm/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils.ts"],"sourcesContent":["import { Timer } from './snaps/Timer';\n\n/**\n * Takes two objects and does a Set Difference of them.\n * Set Difference is generally defined as follows:\n * ```\n * 𝑥 ∈ A ∖ B ⟺ 𝑥 ∈ A ∧ 𝑥 ∉ B\n * ```\n * Meaning that the returned object contains all properties of A expect those that also\n * appear in B. Notice that properties that appear in B, but not in A, have no effect.\n *\n * @see [Set Difference]{@link https://proofwiki.org/wiki/Definition:Set_Difference}\n * @param objectA - The object on which the difference is being calculated.\n * @param objectB - The object whose properties will be removed from objectA.\n * @returns The objectA without properties from objectB.\n */\nexport function setDiff<\n  ObjectA extends Record<any, unknown>,\n  ObjectB extends Record<any, unknown>,\n>(objectA: ObjectA, objectB: ObjectB): Diff<ObjectA, ObjectB> {\n  return Object.entries(objectA).reduce<Record<any, unknown>>(\n    (acc, [key, value]) => {\n      if (!(key in objectB)) {\n        acc[key] = value;\n      }\n      return acc;\n    },\n    {},\n  ) as Diff<ObjectA, ObjectB>;\n}\n\n/**\n * A Promise that delays its return for a given amount of milliseconds.\n *\n * @param ms - Milliseconds to delay the execution for.\n * @param result - The result to return from the Promise after delay.\n * @returns A promise that is void if no result provided, result otherwise.\n * @template Result - The `result`.\n */\nexport function delay<Result = void>(\n  ms: number,\n  result?: Result,\n): Promise<Result> & { cancel: () => void } {\n  return delayWithTimer(new Timer(ms), result);\n}\n\n/**\n * A Promise that delays it's return by using a pausable Timer.\n *\n * @param timer - Timer used to control the delay.\n * @param result - The result to return from the Promise after delay.\n * @returns A promise that is void if no result provided, result otherwise.\n * @template Result - The `result`.\n */\nexport function delayWithTimer<Result = void>(\n  timer: Timer,\n  result?: Result,\n): Promise<Result> & { cancel: () => void } {\n  let rejectFunc: (reason: Error) => void;\n  const promise: any = new Promise<Result>((resolve: any, reject) => {\n    timer.start(() => {\n      result === undefined ? resolve() : resolve(result);\n    });\n    rejectFunc = reject;\n  });\n\n  promise.cancel = () => {\n    if (timer.status !== 'finished') {\n      timer.cancel();\n      rejectFunc(new Error('The delay has been canceled.'));\n    }\n  };\n  return promise;\n}\n\n/*\n * We use a Symbol instead of rejecting the promise so that Errors thrown\n * by the main promise will propagate.\n */\nexport const hasTimedOut = Symbol(\n  'Used to check if the requested promise has timeout (see withTimeout)',\n);\n\n/**\n * Executes the given Promise, if the Timer expires before the Promise settles, we return earlier.\n *\n * NOTE:** The given Promise is not cancelled or interrupted, and will continue to execute uninterrupted. We will just discard its result if it does not complete before the timeout.\n *\n * @param promise - The promise that you want to execute.\n * @param timerOrMs - The timer controlling the timeout or a ms value.\n * @returns The resolved `PromiseValue`, or the hasTimedOut symbol if\n * returning early.\n * @template PromiseValue - The value of the Promise.\n */\nexport async function withTimeout<PromiseValue = void>(\n  promise: Promise<PromiseValue>,\n  timerOrMs: Timer | number,\n): Promise<PromiseValue | typeof hasTimedOut> {\n  const timer =\n    typeof timerOrMs === 'number' ? new Timer(timerOrMs) : timerOrMs;\n  const delayPromise = delayWithTimer(timer, hasTimedOut);\n  try {\n    return await Promise.race([promise, delayPromise]);\n  } finally {\n    delayPromise.cancel();\n  }\n}\n\n/**\n * Checks whether the type is composed of literal types\n *\n * @returns @type {true} if whole type is composed of literals, @type {false} if whole type is not literals, @type {boolean} if mixed\n * @example\n * ```\n * type t1 = IsLiteral<1 | 2 | \"asd\" | true>;\n * // t1 = true\n *\n * type t2 = IsLiteral<number | string>;\n * // t2 = false\n *\n * type t3 = IsLiteral<1 | string>;\n * // t3 = boolean\n *\n * const s = Symbol();\n * type t4 = IsLiteral<typeof s>;\n * // t4 = true\n *\n * type t5 = IsLiteral<symbol>\n * // t5 = false;\n * ```\n */\ntype IsLiteral<Type> = Type extends string | number | boolean | symbol\n  ? Extract<string | number | boolean | symbol, Type> extends never\n    ? true\n    : false\n  : false;\n\n/**\n * Returns all keys of an object, that are literal, as an union\n *\n * @example\n * ```\n * type t1 = _LiteralKeys<{a: number, b: 0, c: 'foo', d: string}>\n * // t1 = 'b' | 'c'\n * ```\n * @see [Literal types]{@link https://www.typescriptlang.org/docs/handbook/literal-types.html}\n */\ntype LiteralKeys<Type> = NonNullable<\n  {\n    [Key in keyof Type]: IsLiteral<Key> extends true ? Key : never;\n  }[keyof Type]\n>;\n\n/**\n * Returns all keys of an object, that are not literal, as an union\n *\n * @example\n * ```\n * type t1 = _NonLiteralKeys<{a: number, b: 0, c: 'foo', d: string}>\n * // t1 = 'a' | 'd'\n * ```\n * @see [Literal types]{@link https://www.typescriptlang.org/docs/handbook/literal-types.html}\n */\ntype NonLiteralKeys<Type> = NonNullable<\n  {\n    [Key in keyof Type]: IsLiteral<Key> extends false ? Key : never;\n  }[keyof Type]\n>;\n\n/**\n * A set difference of two objects based on their keys\n *\n * @example\n * ```\n * type t1 = Diff<{a: string, b: string}, {a: number}>\n * // t1 = {b: string};\n * type t2 = Diff<{a: string, 0: string}, Record<string, unknown>>;\n * // t2 = { a?: string, 0: string};\n * type t3 = Diff<{a: string, 0: string, 1: string}, Record<1 | string, unknown>>;\n * // t3 = {a?: string, 0: string}\n * ```\n * @see {@link setDiff} for the main use-case\n */\nexport type Diff<First, Second> = Omit<First, LiteralKeys<Second>> &\n  Partial<Pick<First, Extract<keyof First, NonLiteralKeys<Second>>>>;\n\n/**\n * Makes every specified property of the specified object type mutable.\n *\n * @template Type - The object whose readonly properties to make mutable.\n * @template TargetKey - The property key(s) to make mutable.\n */\nexport type Mutable<\n  Type extends Record<string, unknown>,\n  TargetKey extends string,\n> = {\n  -readonly [Key in keyof Pick<Type, TargetKey>]: Type[Key];\n} & {\n  [Key in keyof Omit<Type, TargetKey>]: Type[Key];\n};\n"],"names":["Timer","setDiff","objectA","objectB","Object","entries","reduce","acc","key","value","delay","ms","result","delayWithTimer","timer","rejectFunc","promise","Promise","resolve","reject","start","undefined","cancel","status","Error","hasTimedOut","Symbol","withTimeout","timerOrMs","delayPromise","race"],"mappings":"AAAA,SAASA,KAAK,QAAQ,gBAAgB;AAEtC;;;;;;;;;;;;;CAaC,GACD,OAAO,SAASC,QAGdC,OAAgB,EAAEC,OAAgB;IAClC,OAAOC,OAAOC,OAAO,CAACH,SAASI,MAAM,CACnC,CAACC,KAAK,CAACC,KAAKC,MAAM;QAChB,IAAI,CAAED,CAAAA,OAAOL,OAAM,GAAI;YACrBI,GAAG,CAACC,IAAI,GAAGC;QACb;QACA,OAAOF;IACT,GACA,CAAC;AAEL;AAEA;;;;;;;CAOC,GACD,OAAO,SAASG,MACdC,EAAU,EACVC,MAAe;IAEf,OAAOC,eAAe,IAAIb,MAAMW,KAAKC;AACvC;AAEA;;;;;;;CAOC,GACD,OAAO,SAASC,eACdC,KAAY,EACZF,MAAe;IAEf,IAAIG;IACJ,MAAMC,UAAe,IAAIC,QAAgB,CAACC,SAAcC;QACtDL,MAAMM,KAAK,CAAC;YACVR,WAAWS,YAAYH,YAAYA,QAAQN;QAC7C;QACAG,aAAaI;IACf;IAEAH,QAAQM,MAAM,GAAG;QACf,IAAIR,MAAMS,MAAM,KAAK,YAAY;YAC/BT,MAAMQ,MAAM;YACZP,WAAW,IAAIS,MAAM;QACvB;IACF;IACA,OAAOR;AACT;AAEA;;;CAGC,GACD,OAAO,MAAMS,cAAcC,OACzB,wEACA;AAEF;;;;;;;;;;CAUC,GACD,OAAO,eAAeC,YACpBX,OAA8B,EAC9BY,SAAyB;IAEzB,MAAMd,QACJ,OAAOc,cAAc,WAAW,IAAI5B,MAAM4B,aAAaA;IACzD,MAAMC,eAAehB,eAAeC,OAAOW;IAC3C,IAAI;QACF,OAAO,MAAMR,QAAQa,IAAI,CAAC;YAACd;YAASa;SAAa;IACnD,SAAU;QACRA,aAAaP,MAAM;IACrB;AACF"}

package/dist/{cronjob → types/cronjob}/CronjobController.d.ts

@@ -1,10 +1,11 @@
-import { BaseControllerV2 as BaseController, RestrictedControllerMessenger } from '@metamask/base-controller';
-import { GetPermissions } from '@metamask/permission-controller';
-import { SnapId, CronjobSpecification } from '@metamask/snaps-utils';
-import { GetAllSnaps, HandleSnapRequest, SnapInstalled, SnapRemoved, SnapUpdated } from '..';
+import type { RestrictedControllerMessenger } from '@metamask/base-controller';
+import { BaseControllerV2 as BaseController } from '@metamask/base-controller';
+import type { GetPermissions } from '@metamask/permission-controller';
+import type { SnapId, ValidatedSnapId, CronjobSpecification } from '@metamask/snaps-utils';
+import type { GetAllSnaps, HandleSnapRequest, SnapDisabled, SnapEnabled, SnapInstalled, SnapRemoved, SnapUpdated } from '..';
 import { Timer } from '../snaps/Timer';
 export declare type CronjobControllerActions = GetAllSnaps | HandleSnapRequest | GetPermissions;
-export declare type CronjobControllerEvents = SnapInstalled | SnapRemoved | SnapUpdated;
+export declare type CronjobControllerEvents = SnapInstalled | SnapRemoved | SnapUpdated | SnapEnabled | SnapDisabled;
 export declare type CronjobControllerMessenger = RestrictedControllerMessenger<'CronjobController', CronjobControllerActions, CronjobControllerEvents, CronjobControllerActions['type'], CronjobControllerEvents['type']>;
 export declare const DAILY_TIMEOUT: number;
 export declare type CronjobControllerArgs = {
@@ -17,7 +18,7 @@ export declare type CronjobControllerArgs = {
 export declare type Cronjob = {
     timer?: Timer;
     id: string;
-    snapId: SnapId;
+    snapId: ValidatedSnapId;
 } & CronjobSpecification;
 export declare type StoredJobInformation = {
     lastRun: number;
@@ -52,7 +53,7 @@ export declare class CronjobController extends BaseController<typeof controllerN
      *
      * @param snapId - ID of a snap.
      */
-    register(snapId: SnapId): void;
+    register(snapId: ValidatedSnapId): void;
     /**
      * Schedule a new job.
      * This will interpret the cron expression and tell the timer to execute the job
@@ -95,17 +96,17 @@ export declare class CronjobController extends BaseController<typeof controllerN
      */
     destroy(): void;
     /**
-     * Handle cron jobs on 'snapInstalled' event.
+     * Handle events that should cause cronjobs to be registered.
      *
      * @param snap - Basic Snap information.
      */
-    private _handleEventSnapInstalled;
+    private _handleSnapRegisterEvent;
     /**
-     * Handle cron jobs on 'snapRemoved' event.
+     * Handle events that should cause cronjobs to be unregistered.
      *
      * @param snap - Basic Snap information.
      */
-    private _handleEventSnapRemoved;
+    private _handleSnapUnregisterEvent;
     /**
      * Handle cron jobs on 'snapUpdated' event.
      *

package/dist/{fsm.d.ts → types/fsm.d.ts}

@@ -1,4 +1,4 @@
-import { EventObject, StateMachine, Typestate } from '@xstate/fsm';
+import type { EventObject, StateMachine, Typestate } from '@xstate/fsm';
 /**
  * Validates the set-up of a @xstate/fsm machine.
  *

package/dist/{index.d.ts → types/index.d.ts}

@@ -2,5 +2,4 @@ export type { Json } from '@metamask/utils';
 export * from './services';
 export * from './snaps';
 export * from './utils';
-export * from './multichain';
 export * from './cronjob';

package/dist/{services → types/services}/AbstractExecutionService.d.ts

@@ -1,10 +1,10 @@
 /// <reference types="node" />
 import ObjectMultiplex from '@metamask/object-multiplex';
-import { BasePostMessageStream } from '@metamask/post-message-stream';
-import { SnapRpcHookArgs } from '@metamask/snaps-utils';
+import type { BasePostMessageStream } from '@metamask/post-message-stream';
+import type { SnapRpcHookArgs } from '@metamask/snaps-utils';
 import { JsonRpcEngine } from 'json-rpc-engine';
-import { Duplex } from 'stream';
-import { ExecutionService, ExecutionServiceMessenger, SnapExecutionData } from './ExecutionService';
+import type { Duplex } from 'stream';
+import type { ExecutionService, ExecutionServiceMessenger, SnapExecutionData } from './ExecutionService';
 export declare type SetupSnapProvider = (snapId: string, stream: Duplex) => void;
 export declare type ExecutionServiceArgs = {
     setupSnapProvider: SetupSnapProvider;

package/dist/{services → types/services}/ExecutionService.d.ts

@@ -1,6 +1,6 @@
-import { RestrictedControllerMessenger } from '@metamask/base-controller';
-import { SnapId, SnapRpcHookArgs } from '@metamask/snaps-utils';
-import { Json } from '@metamask/types';
+import type { RestrictedControllerMessenger } from '@metamask/base-controller';
+import type { SnapId, SnapRpcHookArgs } from '@metamask/snaps-utils';
+import type { Json } from '@metamask/utils';
 declare type TerminateSnap = (snapId: string) => Promise<void>;
 declare type TerminateAll = () => Promise<void>;
 declare type ExecuteSnap = (snapData: SnapExecutionData) => Promise<unknown>;

package/dist/{services/offscreen/OffscreenPostMessageStream.d.ts → types/services/ProxyPostMessageStream.d.ts}

@@ -1,35 +1,35 @@
 import { BasePostMessageStream } from '@metamask/post-message-stream';
-import { JsonRpcRequest } from '@metamask/utils';
-export declare type OffscreenPostMessageStreamArgs = {
+import type { JsonRpcRequest } from '@metamask/utils';
+export declare type ProxyPostMessageStreamArgs = {
     stream: BasePostMessageStream;
     jobId: string;
-    frameUrl: string;
+    extra?: Record<string, unknown>;
 };
-export declare type OffscreenPostMessage = {
+export declare type ProxyPostMessage = {
     jobId: string;
     data: JsonRpcRequest;
+    extra?: Record<string, unknown>;
 };
 /**
  * A post message stream that wraps messages in a job ID, before sending them
  * over the underlying stream.
  */
-export declare class OffscreenPostMessageStream extends BasePostMessageStream {
+export declare class ProxyPostMessageStream extends BasePostMessageStream {
     #private;
     /**
-     * Initializes a new `OffscreenPostMessageStream` instance.
+     * Initializes a new `ProxyPostMessageStream` instance.
      *
      * @param args - The constructor arguments.
      * @param args.stream - The underlying stream to use for communication.
      * @param args.jobId - The ID of the job this stream is associated with.
-     * @param args.frameUrl - The URL of the frame to load inside the offscreen
-     * document.
+     * @param args.extra - Extra data to include in the post message.
      */
-    constructor({ stream, jobId, frameUrl }: OffscreenPostMessageStreamArgs);
+    constructor({ stream, jobId, extra }: ProxyPostMessageStreamArgs);
     /**
      * Write data to the underlying stream. This wraps the data in an object with
      * the job ID.
      *
      * @param data - The data to write.
      */
-    _postMessage(data: OffscreenPostMessage): void;
+    _postMessage(data: ProxyPostMessage): void;
 }

package/dist/{services → types/services}/browser.d.ts

@@ -1,4 +1,6 @@
 export * from './AbstractExecutionService';
 export * from './ExecutionService';
+export * from './ProxyPostMessageStream';
 export * from './iframe';
 export * from './offscreen';
+export { WebWorkerExecutionService } from './webworker';

package/dist/{services → types/services}/iframe/IframeExecutionService.d.ts

@@ -1,5 +1,6 @@
-import { BasePostMessageStream } from '@metamask/post-message-stream';
-import { Job, AbstractExecutionService, ExecutionServiceArgs } from '../AbstractExecutionService';
+import type { BasePostMessageStream } from '@metamask/post-message-stream';
+import type { Job, ExecutionServiceArgs } from '../AbstractExecutionService';
+import { AbstractExecutionService } from '../AbstractExecutionService';
 declare type IframeExecutionEnvironmentServiceArgs = {
     iframeUrl: URL;
 } & ExecutionServiceArgs;

package/dist/{services → types/services}/index.d.ts

@@ -1,5 +1,7 @@
 export * from './AbstractExecutionService';
 export * from './ExecutionService';
+export * from './ProxyPostMessageStream';
 export * from './iframe';
 export * from './node';
 export * from './offscreen';
+export { WebWorkerExecutionService } from './webworker';

package/dist/{services → types/services}/node/NodeProcessExecutionService.d.ts

@@ -1,7 +1,8 @@
 /// <reference types="node" />
-import { BasePostMessageStream } from '@metamask/post-message-stream';
-import { ChildProcess } from 'child_process';
-import { AbstractExecutionService, Job } from '..';
+import type { BasePostMessageStream } from '@metamask/post-message-stream';
+import type { ChildProcess } from 'child_process';
+import type { Job } from '..';
+import { AbstractExecutionService } from '..';
 export declare class NodeProcessExecutionService extends AbstractExecutionService<ChildProcess> {
     protected initEnvStream(): Promise<{
         worker: ChildProcess;