@metamask/snaps-controllers 18.0.4 → 19.0.0

package/dist/snaps/index.cjs

@@ -14,9 +14,11 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.SnapController = void 0;
 __exportStar(require("./constants.cjs"), exports);
 __exportStar(require("./location/index.cjs"), exports);
-__exportStar(require("./SnapController.cjs"), exports);
+var SnapController_1 = require("./SnapController.cjs");
+Object.defineProperty(exports, "SnapController", { enumerable: true, get: function () { return SnapController_1.SnapController; } });
 __exportStar(require("./selectors.cjs"), exports);
 __exportStar(require("./registry/index.cjs"), exports);
 //# sourceMappingURL=index.cjs.map

package/dist/snaps/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../../src/snaps/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,kDAA4B;AAC5B,uDAA2B;AAC3B,uDAAiC;AACjC,kDAA4B;AAC5B,uDAA2B","sourcesContent":["export * from './constants';\nexport * from './location';\nexport * from './SnapController';\nexport * from './selectors';\nexport * from './registry';\n"]}
+{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../../src/snaps/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,kDAA4B;AAC5B,uDAA2B;AAwB3B,uDAAkD;AAAzC,gHAAA,cAAc,OAAA;AA4BvB,kDAA4B;AAC5B,uDAA2B","sourcesContent":["export * from './constants';\nexport * from './location';\nexport type {\n  SnapControllerActions,\n  SnapControllerArgs,\n  SnapControllerEvents,\n  SnapControllerGetStateAction,\n  SnapControllerMessenger,\n  SnapControllerSnapBlockedEvent,\n  SnapControllerSnapDisabledEvent,\n  SnapControllerSnapEnabledEvent,\n  SnapControllerSnapInstalledEvent,\n  SnapControllerSnapInstallFailedEvent,\n  SnapControllerSnapInstallStartedEvent,\n  SnapControllerSnapRolledbackEvent,\n  SnapControllerSnapTerminatedEvent,\n  SnapControllerSnapUnblockedEvent,\n  SnapControllerSnapUninstalledEvent,\n  SnapControllerSnapUpdatedEvent,\n  SnapControllerState,\n  SnapControllerStateChangeEvent,\n  PreinstalledSnapFile,\n  PreinstalledSnap,\n  PersistedSnapControllerState,\n} from './SnapController';\nexport { SnapController } from './SnapController';\nexport type {\n  SnapControllerInitAction,\n  SnapControllerUpdateRegistryAction,\n  SnapControllerEnableSnapAction,\n  SnapControllerDisableSnapAction,\n  SnapControllerStopSnapAction,\n  SnapControllerStopAllSnapsAction,\n  SnapControllerIsSnapRunningAction,\n  SnapControllerHasSnapAction,\n  SnapControllerGetSnapAction,\n  SnapControllerUpdateSnapStateAction,\n  SnapControllerClearSnapStateAction,\n  SnapControllerGetSnapStateAction,\n  SnapControllerGetSnapFileAction,\n  SnapControllerIsMinimumPlatformVersionAction,\n  SnapControllerClearStateAction,\n  SnapControllerRemoveSnapAction,\n  SnapControllerRemoveSnapsAction,\n  SnapControllerDisconnectOriginAction,\n  SnapControllerRevokeDynamicSnapPermissionsAction,\n  SnapControllerGetAllSnapsAction,\n  SnapControllerGetRunnableSnapsAction,\n  SnapControllerGetPermittedSnapsAction,\n  SnapControllerInstallSnapsAction,\n  SnapControllerHandleRequestAction,\n  SnapControllerSetClientActiveAction,\n} from './SnapController-method-action-types';\nexport * from './selectors';\nexport * from './registry';\n"]}

package/dist/snaps/index.d.cts

@@ -1,6 +1,8 @@
 export * from "./constants.cjs";
 export * from "./location/index.cjs";
-export * from "./SnapController.cjs";
+export type { SnapControllerActions, SnapControllerArgs, SnapControllerEvents, SnapControllerGetStateAction, SnapControllerMessenger, SnapControllerSnapBlockedEvent, SnapControllerSnapDisabledEvent, SnapControllerSnapEnabledEvent, SnapControllerSnapInstalledEvent, SnapControllerSnapInstallFailedEvent, SnapControllerSnapInstallStartedEvent, SnapControllerSnapRolledbackEvent, SnapControllerSnapTerminatedEvent, SnapControllerSnapUnblockedEvent, SnapControllerSnapUninstalledEvent, SnapControllerSnapUpdatedEvent, SnapControllerState, SnapControllerStateChangeEvent, PreinstalledSnapFile, PreinstalledSnap, PersistedSnapControllerState, } from "./SnapController.cjs";
+export { SnapController } from "./SnapController.cjs";
+export type { SnapControllerInitAction, SnapControllerUpdateRegistryAction, SnapControllerEnableSnapAction, SnapControllerDisableSnapAction, SnapControllerStopSnapAction, SnapControllerStopAllSnapsAction, SnapControllerIsSnapRunningAction, SnapControllerHasSnapAction, SnapControllerGetSnapAction, SnapControllerUpdateSnapStateAction, SnapControllerClearSnapStateAction, SnapControllerGetSnapStateAction, SnapControllerGetSnapFileAction, SnapControllerIsMinimumPlatformVersionAction, SnapControllerClearStateAction, SnapControllerRemoveSnapAction, SnapControllerRemoveSnapsAction, SnapControllerDisconnectOriginAction, SnapControllerRevokeDynamicSnapPermissionsAction, SnapControllerGetAllSnapsAction, SnapControllerGetRunnableSnapsAction, SnapControllerGetPermittedSnapsAction, SnapControllerInstallSnapsAction, SnapControllerHandleRequestAction, SnapControllerSetClientActiveAction, } from "./SnapController-method-action-types.cjs";
 export * from "./selectors.cjs";
 export * from "./registry/index.cjs";
 //# sourceMappingURL=index.d.cts.map

package/dist/snaps/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../../src/snaps/index.ts"],"names":[],"mappings":"AAAA,gCAA4B;AAC5B,qCAA2B;AAC3B,qCAAiC;AACjC,gCAA4B;AAC5B,qCAA2B"}
+{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../../src/snaps/index.ts"],"names":[],"mappings":"AAAA,gCAA4B;AAC5B,qCAA2B;AAC3B,YAAY,EACV,qBAAqB,EACrB,kBAAkB,EAClB,oBAAoB,EACpB,4BAA4B,EAC5B,uBAAuB,EACvB,8BAA8B,EAC9B,+BAA+B,EAC/B,8BAA8B,EAC9B,gCAAgC,EAChC,oCAAoC,EACpC,qCAAqC,EACrC,iCAAiC,EACjC,iCAAiC,EACjC,gCAAgC,EAChC,kCAAkC,EAClC,8BAA8B,EAC9B,mBAAmB,EACnB,8BAA8B,EAC9B,oBAAoB,EACpB,gBAAgB,EAChB,4BAA4B,GAC7B,6BAAyB;AAC1B,OAAO,EAAE,cAAc,EAAE,6BAAyB;AAClD,YAAY,EACV,wBAAwB,EACxB,kCAAkC,EAClC,8BAA8B,EAC9B,+BAA+B,EAC/B,4BAA4B,EAC5B,gCAAgC,EAChC,iCAAiC,EACjC,2BAA2B,EAC3B,2BAA2B,EAC3B,mCAAmC,EACnC,kCAAkC,EAClC,gCAAgC,EAChC,+BAA+B,EAC/B,4CAA4C,EAC5C,8BAA8B,EAC9B,8BAA8B,EAC9B,+BAA+B,EAC/B,oCAAoC,EACpC,gDAAgD,EAChD,+BAA+B,EAC/B,oCAAoC,EACpC,qCAAqC,EACrC,gCAAgC,EAChC,iCAAiC,EACjC,mCAAmC,GACpC,iDAA6C;AAC9C,gCAA4B;AAC5B,qCAA2B"}

package/dist/snaps/index.d.mts

@@ -1,6 +1,8 @@
 export * from "./constants.mjs";
 export * from "./location/index.mjs";
-export * from "./SnapController.mjs";
+export type { SnapControllerActions, SnapControllerArgs, SnapControllerEvents, SnapControllerGetStateAction, SnapControllerMessenger, SnapControllerSnapBlockedEvent, SnapControllerSnapDisabledEvent, SnapControllerSnapEnabledEvent, SnapControllerSnapInstalledEvent, SnapControllerSnapInstallFailedEvent, SnapControllerSnapInstallStartedEvent, SnapControllerSnapRolledbackEvent, SnapControllerSnapTerminatedEvent, SnapControllerSnapUnblockedEvent, SnapControllerSnapUninstalledEvent, SnapControllerSnapUpdatedEvent, SnapControllerState, SnapControllerStateChangeEvent, PreinstalledSnapFile, PreinstalledSnap, PersistedSnapControllerState, } from "./SnapController.mjs";
+export { SnapController } from "./SnapController.mjs";
+export type { SnapControllerInitAction, SnapControllerUpdateRegistryAction, SnapControllerEnableSnapAction, SnapControllerDisableSnapAction, SnapControllerStopSnapAction, SnapControllerStopAllSnapsAction, SnapControllerIsSnapRunningAction, SnapControllerHasSnapAction, SnapControllerGetSnapAction, SnapControllerUpdateSnapStateAction, SnapControllerClearSnapStateAction, SnapControllerGetSnapStateAction, SnapControllerGetSnapFileAction, SnapControllerIsMinimumPlatformVersionAction, SnapControllerClearStateAction, SnapControllerRemoveSnapAction, SnapControllerRemoveSnapsAction, SnapControllerDisconnectOriginAction, SnapControllerRevokeDynamicSnapPermissionsAction, SnapControllerGetAllSnapsAction, SnapControllerGetRunnableSnapsAction, SnapControllerGetPermittedSnapsAction, SnapControllerInstallSnapsAction, SnapControllerHandleRequestAction, SnapControllerSetClientActiveAction, } from "./SnapController-method-action-types.mjs";
 export * from "./selectors.mjs";
 export * from "./registry/index.mjs";
 //# sourceMappingURL=index.d.mts.map

package/dist/snaps/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../src/snaps/index.ts"],"names":[],"mappings":"AAAA,gCAA4B;AAC5B,qCAA2B;AAC3B,qCAAiC;AACjC,gCAA4B;AAC5B,qCAA2B"}
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../src/snaps/index.ts"],"names":[],"mappings":"AAAA,gCAA4B;AAC5B,qCAA2B;AAC3B,YAAY,EACV,qBAAqB,EACrB,kBAAkB,EAClB,oBAAoB,EACpB,4BAA4B,EAC5B,uBAAuB,EACvB,8BAA8B,EAC9B,+BAA+B,EAC/B,8BAA8B,EAC9B,gCAAgC,EAChC,oCAAoC,EACpC,qCAAqC,EACrC,iCAAiC,EACjC,iCAAiC,EACjC,gCAAgC,EAChC,kCAAkC,EAClC,8BAA8B,EAC9B,mBAAmB,EACnB,8BAA8B,EAC9B,oBAAoB,EACpB,gBAAgB,EAChB,4BAA4B,GAC7B,6BAAyB;AAC1B,OAAO,EAAE,cAAc,EAAE,6BAAyB;AAClD,YAAY,EACV,wBAAwB,EACxB,kCAAkC,EAClC,8BAA8B,EAC9B,+BAA+B,EAC/B,4BAA4B,EAC5B,gCAAgC,EAChC,iCAAiC,EACjC,2BAA2B,EAC3B,2BAA2B,EAC3B,mCAAmC,EACnC,kCAAkC,EAClC,gCAAgC,EAChC,+BAA+B,EAC/B,4CAA4C,EAC5C,8BAA8B,EAC9B,8BAA8B,EAC9B,+BAA+B,EAC/B,oCAAoC,EACpC,gDAAgD,EAChD,+BAA+B,EAC/B,oCAAoC,EACpC,qCAAqC,EACrC,gCAAgC,EAChC,iCAAiC,EACjC,mCAAmC,GACpC,iDAA6C;AAC9C,gCAA4B;AAC5B,qCAA2B"}

package/dist/snaps/index.mjs

@@ -1,6 +1,6 @@
 export * from "./constants.mjs";
 export * from "./location/index.mjs";
-export * from "./SnapController.mjs";
+export { SnapController } from "./SnapController.mjs";
 export * from "./selectors.mjs";
 export * from "./registry/index.mjs";
 //# sourceMappingURL=index.mjs.map

package/dist/snaps/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../src/snaps/index.ts"],"names":[],"mappings":"AAAA,gCAA4B;AAC5B,qCAA2B;AAC3B,qCAAiC;AACjC,gCAA4B;AAC5B,qCAA2B","sourcesContent":["export * from './constants';\nexport * from './location';\nexport * from './SnapController';\nexport * from './selectors';\nexport * from './registry';\n"]}
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../src/snaps/index.ts"],"names":[],"mappings":"AAAA,gCAA4B;AAC5B,qCAA2B;AAwB3B,OAAO,EAAE,cAAc,EAAE,6BAAyB;AA4BlD,gCAA4B;AAC5B,qCAA2B","sourcesContent":["export * from './constants';\nexport * from './location';\nexport type {\n  SnapControllerActions,\n  SnapControllerArgs,\n  SnapControllerEvents,\n  SnapControllerGetStateAction,\n  SnapControllerMessenger,\n  SnapControllerSnapBlockedEvent,\n  SnapControllerSnapDisabledEvent,\n  SnapControllerSnapEnabledEvent,\n  SnapControllerSnapInstalledEvent,\n  SnapControllerSnapInstallFailedEvent,\n  SnapControllerSnapInstallStartedEvent,\n  SnapControllerSnapRolledbackEvent,\n  SnapControllerSnapTerminatedEvent,\n  SnapControllerSnapUnblockedEvent,\n  SnapControllerSnapUninstalledEvent,\n  SnapControllerSnapUpdatedEvent,\n  SnapControllerState,\n  SnapControllerStateChangeEvent,\n  PreinstalledSnapFile,\n  PreinstalledSnap,\n  PersistedSnapControllerState,\n} from './SnapController';\nexport { SnapController } from './SnapController';\nexport type {\n  SnapControllerInitAction,\n  SnapControllerUpdateRegistryAction,\n  SnapControllerEnableSnapAction,\n  SnapControllerDisableSnapAction,\n  SnapControllerStopSnapAction,\n  SnapControllerStopAllSnapsAction,\n  SnapControllerIsSnapRunningAction,\n  SnapControllerHasSnapAction,\n  SnapControllerGetSnapAction,\n  SnapControllerUpdateSnapStateAction,\n  SnapControllerClearSnapStateAction,\n  SnapControllerGetSnapStateAction,\n  SnapControllerGetSnapFileAction,\n  SnapControllerIsMinimumPlatformVersionAction,\n  SnapControllerClearStateAction,\n  SnapControllerRemoveSnapAction,\n  SnapControllerRemoveSnapsAction,\n  SnapControllerDisconnectOriginAction,\n  SnapControllerRevokeDynamicSnapPermissionsAction,\n  SnapControllerGetAllSnapsAction,\n  SnapControllerGetRunnableSnapsAction,\n  SnapControllerGetPermittedSnapsAction,\n  SnapControllerInstallSnapsAction,\n  SnapControllerHandleRequestAction,\n  SnapControllerSetClientActiveAction,\n} from './SnapController-method-action-types';\nexport * from './selectors';\nexport * from './registry';\n"]}

package/dist/snaps/registry/SnapRegistryController-method-action-types.cjs

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * This file is auto generated by `scripts/generate-method-action-types.ts`.
+ * Do not edit manually.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=SnapRegistryController-method-action-types.cjs.map

package/dist/snaps/registry/SnapRegistryController-method-action-types.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"SnapRegistryController-method-action-types.cjs","sourceRoot":"","sources":["../../../src/snaps/registry/SnapRegistryController-method-action-types.ts"],"names":[],"mappings":";AAAA;;;GAGG","sourcesContent":["/**\n * This file is auto generated by `scripts/generate-method-action-types.ts`.\n * Do not edit manually.\n */\n\nimport type { SnapRegistryController } from './SnapRegistryController';\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 */\nexport type SnapRegistryControllerRequestUpdateAction = {\n  type: `SnapRegistryController:requestUpdate`;\n  handler: SnapRegistryController['requestUpdate'];\n};\n\nexport type SnapRegistryControllerGetAction = {\n  type: `SnapRegistryController:get`;\n  handler: SnapRegistryController['get'];\n};\n\n/**\n * Find an allowlisted version within a specified version range. Otherwise return the version range itself.\n *\n * @param snapId - The ID of the snap we are trying to resolve a version for.\n * @param versionRange - The version range.\n * @param refetch - An optional flag used to determine if we are refetching the registry.\n * @returns An allowlisted version within the specified version range if available otherwise returns the input version range.\n */\nexport type SnapRegistryControllerResolveVersionAction = {\n  type: `SnapRegistryController:resolveVersion`;\n  handler: SnapRegistryController['resolveVersion'];\n};\n\n/**\n * Get metadata for the given snap ID, if available, without updating registry.\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 */\nexport type SnapRegistryControllerGetMetadataAction = {\n  type: `SnapRegistryController:getMetadata`;\n  handler: SnapRegistryController['getMetadata'];\n};\n\n/**\n * Union of all SnapRegistryController action types.\n */\nexport type SnapRegistryControllerMethodActions =\n  | SnapRegistryControllerRequestUpdateAction\n  | SnapRegistryControllerGetAction\n  | SnapRegistryControllerResolveVersionAction\n  | SnapRegistryControllerGetMetadataAction;\n"]}

package/dist/snaps/registry/SnapRegistryController-method-action-types.d.cts

@@ -0,0 +1,46 @@
+/**
+ * This file is auto generated by `scripts/generate-method-action-types.ts`.
+ * Do not edit manually.
+ */
+import type { SnapRegistryController } from "./SnapRegistryController.cjs";
+/**
+ * Triggers an update of the registry database.
+ *
+ * If an existing update is in progress this function will await that update.
+ */
+export type SnapRegistryControllerRequestUpdateAction = {
+    type: `SnapRegistryController:requestUpdate`;
+    handler: SnapRegistryController['requestUpdate'];
+};
+export type SnapRegistryControllerGetAction = {
+    type: `SnapRegistryController:get`;
+    handler: SnapRegistryController['get'];
+};
+/**
+ * Find an allowlisted version within a specified version range. Otherwise return the version range itself.
+ *
+ * @param snapId - The ID of the snap we are trying to resolve a version for.
+ * @param versionRange - The version range.
+ * @param refetch - An optional flag used to determine if we are refetching the registry.
+ * @returns An allowlisted version within the specified version range if available otherwise returns the input version range.
+ */
+export type SnapRegistryControllerResolveVersionAction = {
+    type: `SnapRegistryController:resolveVersion`;
+    handler: SnapRegistryController['resolveVersion'];
+};
+/**
+ * Get metadata for the given snap ID, if available, without updating registry.
+ *
+ * @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.
+ */
+export type SnapRegistryControllerGetMetadataAction = {
+    type: `SnapRegistryController:getMetadata`;
+    handler: SnapRegistryController['getMetadata'];
+};
+/**
+ * Union of all SnapRegistryController action types.
+ */
+export type SnapRegistryControllerMethodActions = SnapRegistryControllerRequestUpdateAction | SnapRegistryControllerGetAction | SnapRegistryControllerResolveVersionAction | SnapRegistryControllerGetMetadataAction;
+//# sourceMappingURL=SnapRegistryController-method-action-types.d.cts.map

package/dist/snaps/registry/SnapRegistryController-method-action-types.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SnapRegistryController-method-action-types.d.cts","sourceRoot":"","sources":["../../../src/snaps/registry/SnapRegistryController-method-action-types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAE,qCAAiC;AAEvE;;;;GAIG;AACH,MAAM,MAAM,yCAAyC,GAAG;IACtD,IAAI,EAAE,sCAAsC,CAAC;IAC7C,OAAO,EAAE,sBAAsB,CAAC,eAAe,CAAC,CAAC;CAClD,CAAC;AAEF,MAAM,MAAM,+BAA+B,GAAG;IAC5C,IAAI,EAAE,4BAA4B,CAAC;IACnC,OAAO,EAAE,sBAAsB,CAAC,KAAK,CAAC,CAAC;CACxC,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,MAAM,0CAA0C,GAAG;IACvD,IAAI,EAAE,uCAAuC,CAAC;IAC9C,OAAO,EAAE,sBAAsB,CAAC,gBAAgB,CAAC,CAAC;CACnD,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,uCAAuC,GAAG;IACpD,IAAI,EAAE,oCAAoC,CAAC;IAC3C,OAAO,EAAE,sBAAsB,CAAC,aAAa,CAAC,CAAC;CAChD,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,mCAAmC,GAC3C,yCAAyC,GACzC,+BAA+B,GAC/B,0CAA0C,GAC1C,uCAAuC,CAAC"}

package/dist/snaps/registry/SnapRegistryController-method-action-types.d.mts

@@ -0,0 +1,46 @@
+/**
+ * This file is auto generated by `scripts/generate-method-action-types.ts`.
+ * Do not edit manually.
+ */
+import type { SnapRegistryController } from "./SnapRegistryController.mjs";
+/**
+ * Triggers an update of the registry database.
+ *
+ * If an existing update is in progress this function will await that update.
+ */
+export type SnapRegistryControllerRequestUpdateAction = {
+    type: `SnapRegistryController:requestUpdate`;
+    handler: SnapRegistryController['requestUpdate'];
+};
+export type SnapRegistryControllerGetAction = {
+    type: `SnapRegistryController:get`;
+    handler: SnapRegistryController['get'];
+};
+/**
+ * Find an allowlisted version within a specified version range. Otherwise return the version range itself.
+ *
+ * @param snapId - The ID of the snap we are trying to resolve a version for.
+ * @param versionRange - The version range.
+ * @param refetch - An optional flag used to determine if we are refetching the registry.
+ * @returns An allowlisted version within the specified version range if available otherwise returns the input version range.
+ */
+export type SnapRegistryControllerResolveVersionAction = {
+    type: `SnapRegistryController:resolveVersion`;
+    handler: SnapRegistryController['resolveVersion'];
+};
+/**
+ * Get metadata for the given snap ID, if available, without updating registry.
+ *
+ * @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.
+ */
+export type SnapRegistryControllerGetMetadataAction = {
+    type: `SnapRegistryController:getMetadata`;
+    handler: SnapRegistryController['getMetadata'];
+};
+/**
+ * Union of all SnapRegistryController action types.
+ */
+export type SnapRegistryControllerMethodActions = SnapRegistryControllerRequestUpdateAction | SnapRegistryControllerGetAction | SnapRegistryControllerResolveVersionAction | SnapRegistryControllerGetMetadataAction;
+//# sourceMappingURL=SnapRegistryController-method-action-types.d.mts.map

package/dist/snaps/registry/SnapRegistryController-method-action-types.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SnapRegistryController-method-action-types.d.mts","sourceRoot":"","sources":["../../../src/snaps/registry/SnapRegistryController-method-action-types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAE,qCAAiC;AAEvE;;;;GAIG;AACH,MAAM,MAAM,yCAAyC,GAAG;IACtD,IAAI,EAAE,sCAAsC,CAAC;IAC7C,OAAO,EAAE,sBAAsB,CAAC,eAAe,CAAC,CAAC;CAClD,CAAC;AAEF,MAAM,MAAM,+BAA+B,GAAG;IAC5C,IAAI,EAAE,4BAA4B,CAAC;IACnC,OAAO,EAAE,sBAAsB,CAAC,KAAK,CAAC,CAAC;CACxC,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,MAAM,0CAA0C,GAAG;IACvD,IAAI,EAAE,uCAAuC,CAAC;IAC9C,OAAO,EAAE,sBAAsB,CAAC,gBAAgB,CAAC,CAAC;CACnD,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,uCAAuC,GAAG;IACpD,IAAI,EAAE,oCAAoC,CAAC;IAC3C,OAAO,EAAE,sBAAsB,CAAC,aAAa,CAAC,CAAC;CAChD,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,mCAAmC,GAC3C,yCAAyC,GACzC,+BAA+B,GAC/B,0CAA0C,GAC1C,uCAAuC,CAAC"}

package/dist/snaps/registry/SnapRegistryController-method-action-types.mjs

@@ -0,0 +1,6 @@
+/**
+ * This file is auto generated by `scripts/generate-method-action-types.ts`.
+ * Do not edit manually.
+ */
+export {};
+//# sourceMappingURL=SnapRegistryController-method-action-types.mjs.map

package/dist/snaps/registry/SnapRegistryController-method-action-types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"SnapRegistryController-method-action-types.mjs","sourceRoot":"","sources":["../../../src/snaps/registry/SnapRegistryController-method-action-types.ts"],"names":[],"mappings":"AAAA;;;GAGG","sourcesContent":["/**\n * This file is auto generated by `scripts/generate-method-action-types.ts`.\n * Do not edit manually.\n */\n\nimport type { SnapRegistryController } from './SnapRegistryController';\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 */\nexport type SnapRegistryControllerRequestUpdateAction = {\n  type: `SnapRegistryController:requestUpdate`;\n  handler: SnapRegistryController['requestUpdate'];\n};\n\nexport type SnapRegistryControllerGetAction = {\n  type: `SnapRegistryController:get`;\n  handler: SnapRegistryController['get'];\n};\n\n/**\n * Find an allowlisted version within a specified version range. Otherwise return the version range itself.\n *\n * @param snapId - The ID of the snap we are trying to resolve a version for.\n * @param versionRange - The version range.\n * @param refetch - An optional flag used to determine if we are refetching the registry.\n * @returns An allowlisted version within the specified version range if available otherwise returns the input version range.\n */\nexport type SnapRegistryControllerResolveVersionAction = {\n  type: `SnapRegistryController:resolveVersion`;\n  handler: SnapRegistryController['resolveVersion'];\n};\n\n/**\n * Get metadata for the given snap ID, if available, without updating registry.\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 */\nexport type SnapRegistryControllerGetMetadataAction = {\n  type: `SnapRegistryController:getMetadata`;\n  handler: SnapRegistryController['getMetadata'];\n};\n\n/**\n * Union of all SnapRegistryController action types.\n */\nexport type SnapRegistryControllerMethodActions =\n  | SnapRegistryControllerRequestUpdateAction\n  | SnapRegistryControllerGetAction\n  | SnapRegistryControllerResolveVersionAction\n  | SnapRegistryControllerGetMetadataAction;\n"]}

package/dist/snaps/registry/{json.cjs → SnapRegistryController.cjs}

@@ -1,22 +1,28 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.JsonSnapsRegistry = void 0;
+exports.SnapRegistryController = void 0;
 const base_controller_1 = require("@metamask/base-controller");
 const snaps_registry_1 = require("@metamask/snaps-registry");
 const snaps_utils_1 = require("@metamask/snaps-utils");
 const utils_1 = require("@metamask/utils");
-const registry_1 = require("./registry.cjs");
+const types_1 = require("./types.cjs");
 const SNAP_REGISTRY_URL = 'https://acl.execution.metamask.io/latest/registry.json';
 const SNAP_REGISTRY_SIGNATURE_URL = 'https://acl.execution.metamask.io/latest/signature.json';
 const DEFAULT_PUBLIC_KEY = '0x025b65308f0f0fb8bc7f7ff87bfc296e0330eee5d3c1d1ee4a048b2fd6a86fa0a6';
-const controllerName = 'SnapsRegistry';
+const controllerName = 'SnapRegistryController';
+const MESSENGER_EXPOSED_METHODS = [
+    'get',
+    'getMetadata',
+    'resolveVersion',
+    'requestUpdate',
+];
 const defaultState = {
     database: null,
     signature: null,
     lastUpdated: null,
     databaseUnavailable: false,
 };
-class JsonSnapsRegistry extends base_controller_1.BaseController {
+class SnapRegistryController extends base_controller_1.BaseController {
     #url;
     #publicKey;
     #clientConfig;
@@ -69,10 +75,7 @@ class JsonSnapsRegistry extends base_controller_1.BaseController {
         this.#recentFetchThreshold = recentFetchThreshold;
         this.#refetchOnAllowlistMiss = refetchOnAllowlistMiss;
         this.#currentUpdate = null;
-        this.messenger.registerActionHandler('SnapsRegistry:get', async (...args) => this.#get(...args));
-        this.messenger.registerActionHandler('SnapsRegistry:getMetadata', (...args) => this.#getMetadata(...args));
-        this.messenger.registerActionHandler('SnapsRegistry:resolveVersion', async (...args) => this.#resolveVersion(...args));
-        this.messenger.registerActionHandler('SnapsRegistry:update', async () => this.#triggerUpdate());
+        this.messenger.registerMethodActionHandlers(this, MESSENGER_EXPOSED_METHODS);
     }
     #wasRecentlyFetched() {
         return (this.state.lastUpdated &&
@@ -83,7 +86,7 @@ class JsonSnapsRegistry extends base_controller_1.BaseController {
      *
      * If an existing update is in progress this function will await that update.
      */
-    async #triggerUpdate() {
+    async requestUpdate() {
         // If an update is ongoing, wait for that.
         if (this.#currentUpdate) {
             await this.#currentUpdate;
@@ -137,7 +140,7 @@ class JsonSnapsRegistry extends base_controller_1.BaseController {
     }
     async #getDatabase() {
         if (this.state.database === null) {
-            await this.#triggerUpdate();
+            await this.requestUpdate();
         }
         return this.state.database;
     }
@@ -152,7 +155,7 @@ class JsonSnapsRegistry extends base_controller_1.BaseController {
         });
         if (blockedEntry) {
             return {
-                status: registry_1.SnapsRegistryStatus.Blocked,
+                status: types_1.SnapRegistryStatus.Blocked,
                 reason: blockedEntry.reason,
             };
         }
@@ -162,20 +165,20 @@ class JsonSnapsRegistry extends base_controller_1.BaseController {
         const isCompatible = !clientRange ||
             (0, utils_1.satisfiesVersionRange)(this.#clientConfig.version, clientRange);
         if (version && version.checksum === snapInfo.checksum && isCompatible) {
-            return { status: registry_1.SnapsRegistryStatus.Verified };
+            return { status: types_1.SnapRegistryStatus.Verified };
         }
         // For now, if we have an allowlist miss, we can refetch once and try again.
         if (this.#refetchOnAllowlistMiss && !refetch) {
-            await this.#triggerUpdate();
+            await this.requestUpdate();
             return this.#getSingle(snapId, snapInfo, true);
         }
         return {
             status: this.state.databaseUnavailable
-                ? registry_1.SnapsRegistryStatus.Unavailable
-                : registry_1.SnapsRegistryStatus.Unverified,
+                ? types_1.SnapRegistryStatus.Unavailable
+                : types_1.SnapRegistryStatus.Unverified,
         };
     }
-    async #get(snaps) {
+    async get(snaps) {
         return Object.entries(snaps).reduce(async (previousPromise, [snapId, snapInfo]) => {
             const result = await this.#getSingle(snapId, snapInfo);
             const acc = await previousPromise;
@@ -191,12 +194,12 @@ class JsonSnapsRegistry extends base_controller_1.BaseController {
      * @param refetch - An optional flag used to determine if we are refetching the registry.
      * @returns An allowlisted version within the specified version range if available otherwise returns the input version range.
      */
-    async #resolveVersion(snapId, versionRange, refetch = false) {
+    async resolveVersion(snapId, versionRange, refetch = false) {
         const database = await this.#getDatabase();
         const versions = database?.verifiedSnaps[snapId]?.versions ?? null;
         if (!versions && this.#refetchOnAllowlistMiss && !refetch) {
-            await this.#triggerUpdate();
-            return this.#resolveVersion(snapId, versionRange, true);
+            await this.requestUpdate();
+            return this.resolveVersion(snapId, versionRange, true);
         }
         // If we cannot narrow down the version range we return the unaltered version range.
         if (!versions) {
@@ -212,8 +215,8 @@ class JsonSnapsRegistry extends base_controller_1.BaseController {
         }, []);
         const targetVersion = (0, snaps_utils_1.getTargetVersion)(compatibleVersions, versionRange);
         if (!targetVersion && this.#refetchOnAllowlistMiss && !refetch) {
-            await this.#triggerUpdate();
-            return this.#resolveVersion(snapId, versionRange, true);
+            await this.requestUpdate();
+            return this.resolveVersion(snapId, versionRange, true);
         }
         // If we cannot narrow down the version range we return the unaltered version range.
         if (!targetVersion) {
@@ -230,7 +233,7 @@ class JsonSnapsRegistry extends base_controller_1.BaseController {
      * @returns The metadata for the given snap ID, or `null` if the snap is not
      * verified.
      */
-    #getMetadata(snapId) {
+    getMetadata(snapId) {
         return this.state?.database?.verifiedSnaps[snapId]?.metadata ?? null;
     }
     /**
@@ -264,5 +267,5 @@ class JsonSnapsRegistry extends base_controller_1.BaseController {
         return await response.text();
     }
 }
-exports.JsonSnapsRegistry = JsonSnapsRegistry;
-//# sourceMappingURL=json.cjs.map
+exports.SnapRegistryController = SnapRegistryController;
+//# sourceMappingURL=SnapRegistryController.cjs.map

package/dist/snaps/registry/SnapRegistryController.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"SnapRegistryController.cjs","sourceRoot":"","sources":["../../../src/snaps/registry/SnapRegistryController.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  ControllerGetStateAction,\n  ControllerStateChangeEvent,\n} from '@metamask/base-controller';\nimport { BaseController } from '@metamask/base-controller';\nimport type { Messenger } from '@metamask/messenger';\nimport type {\n  SnapsRegistryDatabase,\n  SignatureStruct,\n} from '@metamask/snaps-registry';\nimport { verify } from '@metamask/snaps-registry';\nimport { getTargetVersion } from '@metamask/snaps-utils';\nimport type { Infer } from '@metamask/superstruct';\nimport type { Hex, SemVerRange, SemVerVersion } from '@metamask/utils';\nimport {\n  assert,\n  assertIsSemVerRange,\n  Duration,\n  inMilliseconds,\n  satisfiesVersionRange,\n} from '@metamask/utils';\n\nimport type { SnapRegistryControllerMethodActions } from './SnapRegistryController-method-action-types';\nimport type {\n  SnapRegistryInfo,\n  SnapRegistryMetadata,\n  SnapRegistryRequest,\n  SnapRegistryResult,\n} from './types';\nimport { SnapRegistryStatus } from './types';\n\nconst SNAP_REGISTRY_URL =\n  'https://acl.execution.metamask.io/latest/registry.json';\n\nconst SNAP_REGISTRY_SIGNATURE_URL =\n  'https://acl.execution.metamask.io/latest/signature.json';\n\nconst DEFAULT_PUBLIC_KEY =\n  '0x025b65308f0f0fb8bc7f7ff87bfc296e0330eee5d3c1d1ee4a048b2fd6a86fa0a6';\n\ntype JsonSnapsRegistryUrl = {\n  registry: string;\n  signature: string;\n};\n\nexport type ClientConfig = {\n  type: 'extension' | 'mobile';\n  version: SemVerVersion;\n};\n\nexport type SnapRegistryControllerArgs = {\n  messenger: SnapRegistryControllerMessenger;\n  state?: SnapRegistryControllerState;\n  fetchFunction?: typeof fetch;\n  url?: JsonSnapsRegistryUrl;\n  recentFetchThreshold?: number;\n  refetchOnAllowlistMiss?: boolean;\n  publicKey?: Hex;\n  clientConfig: ClientConfig;\n};\n\nexport type SnapRegistryControllerGetStateAction = ControllerGetStateAction<\n  typeof controllerName,\n  SnapRegistryControllerState\n>;\n\nexport type SnapRegistryControllerActions =\n  | SnapRegistryControllerGetStateAction\n  | SnapRegistryControllerMethodActions;\n\nexport type SnapRegistryControllerStateChangeEvent = ControllerStateChangeEvent<\n  typeof controllerName,\n  SnapRegistryControllerState\n>;\n\nexport type SnapRegistryControllerEvents =\n  SnapRegistryControllerStateChangeEvent;\n\nexport type SnapRegistryControllerMessenger = Messenger<\n  typeof controllerName,\n  SnapRegistryControllerActions,\n  SnapRegistryControllerEvents\n>;\n\nexport type SnapRegistryControllerState = {\n  database: SnapsRegistryDatabase | null;\n  signature: string | null;\n  lastUpdated: number | null;\n  databaseUnavailable: boolean;\n};\n\nconst controllerName = 'SnapRegistryController';\n\nconst MESSENGER_EXPOSED_METHODS = [\n  'get',\n  'getMetadata',\n  'resolveVersion',\n  'requestUpdate',\n] as const;\n\nconst defaultState = {\n  database: null,\n  signature: null,\n  lastUpdated: null,\n  databaseUnavailable: false,\n};\n\nexport class SnapRegistryController extends BaseController<\n  typeof controllerName,\n  SnapRegistryControllerState,\n  SnapRegistryControllerMessenger\n> {\n  readonly #url: JsonSnapsRegistryUrl;\n\n  readonly #publicKey: Hex;\n\n  readonly #clientConfig: ClientConfig;\n\n  readonly #fetchFunction: typeof fetch;\n\n  readonly #recentFetchThreshold: number;\n\n  readonly #refetchOnAllowlistMiss: 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 = DEFAULT_PUBLIC_KEY,\n    clientConfig,\n    fetchFunction = globalThis.fetch.bind(undefined),\n    recentFetchThreshold = inMilliseconds(5, Duration.Minute),\n    refetchOnAllowlistMiss = true,\n  }: SnapRegistryControllerArgs) {\n    super({\n      messenger,\n      metadata: {\n        database: {\n          includeInStateLogs: true,\n          persist: true,\n          includeInDebugSnapshot: false,\n          usedInUi: true,\n        },\n        signature: {\n          includeInStateLogs: true,\n          persist: true,\n          includeInDebugSnapshot: true,\n          usedInUi: false,\n        },\n        lastUpdated: {\n          includeInStateLogs: true,\n          persist: true,\n          includeInDebugSnapshot: true,\n          usedInUi: false,\n        },\n        databaseUnavailable: {\n          includeInStateLogs: true,\n          persist: true,\n          includeInDebugSnapshot: true,\n          usedInUi: false,\n        },\n      },\n      name: controllerName,\n      state: {\n        ...defaultState,\n        ...state,\n      },\n    });\n    this.#url = url;\n    this.#publicKey = publicKey;\n    this.#clientConfig = clientConfig;\n    this.#fetchFunction = fetchFunction;\n    this.#recentFetchThreshold = recentFetchThreshold;\n    this.#refetchOnAllowlistMiss = refetchOnAllowlistMiss;\n    this.#currentUpdate = null;\n\n    this.messenger.registerMethodActionHandlers(\n      this,\n      MESSENGER_EXPOSED_METHODS,\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 requestUpdate() {\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, signature] = await Promise.all([\n        this.#safeFetch(this.#url.registry),\n        this.#safeFetch(this.#url.signature),\n      ]);\n\n      const signatureJson = JSON.parse(signature);\n\n      // If the signature matches the existing state, we can skip verification and don't need to update the database.\n      if (signatureJson.signature === this.state.signature) {\n        this.update((state) => {\n          state.lastUpdated = Date.now();\n          state.databaseUnavailable = false;\n        });\n        return;\n      }\n\n      await this.#verifySignature(database, signatureJson);\n\n      this.update((state) => {\n        state.database = JSON.parse(database);\n        state.lastUpdated = Date.now();\n        state.databaseUnavailable = false;\n        state.signature = signatureJson.signature;\n      });\n    } catch {\n      // Ignore\n      this.update((state) => {\n        state.databaseUnavailable = true;\n      });\n    }\n  }\n\n  async #getDatabase(): Promise<SnapsRegistryDatabase | null> {\n    if (this.state.database === null) {\n      await this.requestUpdate();\n    }\n\n    return this.state.database;\n  }\n\n  async #getSingle(\n    snapId: string,\n    snapInfo: SnapRegistryInfo,\n    refetch = false,\n  ): Promise<SnapRegistryResult> {\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: SnapRegistryStatus.Blocked,\n        reason: blockedEntry.reason,\n      };\n    }\n\n    const verified = database?.verifiedSnaps[snapId];\n    const version = verified?.versions?.[snapInfo.version];\n    const clientRange = version?.clientVersions?.[this.#clientConfig.type];\n    const isCompatible =\n      !clientRange ||\n      satisfiesVersionRange(this.#clientConfig.version, clientRange);\n    if (version && version.checksum === snapInfo.checksum && isCompatible) {\n      return { status: SnapRegistryStatus.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.requestUpdate();\n      return this.#getSingle(snapId, snapInfo, true);\n    }\n    return {\n      status: this.state.databaseUnavailable\n        ? SnapRegistryStatus.Unavailable\n        : SnapRegistryStatus.Unverified,\n    };\n  }\n\n  async get(\n    snaps: SnapRegistryRequest,\n  ): Promise<Record<string, SnapRegistryResult>> {\n    return Object.entries(snaps).reduce<\n      Promise<Record<string, SnapRegistryResult>>\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   * Find an allowlisted version within a specified version range. Otherwise return the version range itself.\n   *\n   * @param snapId - The ID of the snap we are trying to resolve a version for.\n   * @param versionRange - The version range.\n   * @param refetch - An optional flag used to determine if we are refetching the registry.\n   * @returns An allowlisted version within the specified version range if available otherwise returns the input version range.\n   */\n  async resolveVersion(\n    snapId: string,\n    versionRange: SemVerRange,\n    refetch = false,\n  ): Promise<SemVerRange> {\n    const database = await this.#getDatabase();\n    const versions = database?.verifiedSnaps[snapId]?.versions ?? null;\n\n    if (!versions && this.#refetchOnAllowlistMiss && !refetch) {\n      await this.requestUpdate();\n      return this.resolveVersion(snapId, versionRange, true);\n    }\n\n    // If we cannot narrow down the version range we return the unaltered version range.\n    if (!versions) {\n      return versionRange;\n    }\n\n    const compatibleVersions = Object.entries(versions).reduce<SemVerVersion[]>(\n      (accumulator, [version, metadata]) => {\n        const clientRange = metadata.clientVersions?.[this.#clientConfig.type];\n        if (\n          !clientRange ||\n          satisfiesVersionRange(this.#clientConfig.version, clientRange)\n        ) {\n          accumulator.push(version as SemVerVersion);\n        }\n\n        return accumulator;\n      },\n      [],\n    );\n\n    const targetVersion = getTargetVersion(compatibleVersions, versionRange);\n\n    if (!targetVersion && this.#refetchOnAllowlistMiss && !refetch) {\n      await this.requestUpdate();\n      return this.resolveVersion(snapId, versionRange, true);\n    }\n\n    // If we cannot narrow down the version range we return the unaltered version range.\n    if (!targetVersion) {\n      return versionRange;\n    }\n\n    // A semver version is technically also a valid semver range.\n    assertIsSemVerRange(targetVersion);\n    return targetVersion;\n  }\n\n  /**\n   * Get metadata for the given snap ID, if available, without updating registry.\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: string): SnapRegistryMetadata | null {\n    return this.state?.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   */\n  async #verifySignature(\n    database: string,\n    signature: Infer<typeof SignatureStruct>,\n  ) {\n    assert(this.#publicKey, 'No public key provided.');\n\n    const valid = await verify({\n      registry: database,\n      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, { cache: 'no-cache' });\n    if (!response.ok) {\n      throw new Error(`Failed to fetch ${url}.`);\n    }\n\n    return await response.text();\n  }\n}\n"]}

package/dist/snaps/registry/SnapRegistryController.d.cts

@@ -0,0 +1,67 @@
+import type { ControllerGetStateAction, ControllerStateChangeEvent } from "@metamask/base-controller";
+import { BaseController } from "@metamask/base-controller";
+import type { Messenger } from "@metamask/messenger";
+import type { SnapsRegistryDatabase } from "@metamask/snaps-registry";
+import type { Hex, SemVerRange, SemVerVersion } from "@metamask/utils";
+import type { SnapRegistryControllerMethodActions } from "./SnapRegistryController-method-action-types.cjs";
+import type { SnapRegistryMetadata, SnapRegistryRequest, SnapRegistryResult } from "./types.cjs";
+type JsonSnapsRegistryUrl = {
+    registry: string;
+    signature: string;
+};
+export type ClientConfig = {
+    type: 'extension' | 'mobile';
+    version: SemVerVersion;
+};
+export type SnapRegistryControllerArgs = {
+    messenger: SnapRegistryControllerMessenger;
+    state?: SnapRegistryControllerState;
+    fetchFunction?: typeof fetch;
+    url?: JsonSnapsRegistryUrl;
+    recentFetchThreshold?: number;
+    refetchOnAllowlistMiss?: boolean;
+    publicKey?: Hex;
+    clientConfig: ClientConfig;
+};
+export type SnapRegistryControllerGetStateAction = ControllerGetStateAction<typeof controllerName, SnapRegistryControllerState>;
+export type SnapRegistryControllerActions = SnapRegistryControllerGetStateAction | SnapRegistryControllerMethodActions;
+export type SnapRegistryControllerStateChangeEvent = ControllerStateChangeEvent<typeof controllerName, SnapRegistryControllerState>;
+export type SnapRegistryControllerEvents = SnapRegistryControllerStateChangeEvent;
+export type SnapRegistryControllerMessenger = Messenger<typeof controllerName, SnapRegistryControllerActions, SnapRegistryControllerEvents>;
+export type SnapRegistryControllerState = {
+    database: SnapsRegistryDatabase | null;
+    signature: string | null;
+    lastUpdated: number | null;
+    databaseUnavailable: boolean;
+};
+declare const controllerName = "SnapRegistryController";
+export declare class SnapRegistryController extends BaseController<typeof controllerName, SnapRegistryControllerState, SnapRegistryControllerMessenger> {
+    #private;
+    constructor({ messenger, state, url, publicKey, clientConfig, fetchFunction, recentFetchThreshold, refetchOnAllowlistMiss, }: SnapRegistryControllerArgs);
+    /**
+     * Triggers an update of the registry database.
+     *
+     * If an existing update is in progress this function will await that update.
+     */
+    requestUpdate(): Promise<void>;
+    get(snaps: SnapRegistryRequest): Promise<Record<string, SnapRegistryResult>>;
+    /**
+     * Find an allowlisted version within a specified version range. Otherwise return the version range itself.
+     *
+     * @param snapId - The ID of the snap we are trying to resolve a version for.
+     * @param versionRange - The version range.
+     * @param refetch - An optional flag used to determine if we are refetching the registry.
+     * @returns An allowlisted version within the specified version range if available otherwise returns the input version range.
+     */
+    resolveVersion(snapId: string, versionRange: SemVerRange, refetch?: boolean): Promise<SemVerRange>;
+    /**
+     * Get metadata for the given snap ID, if available, without updating registry.
+     *
+     * @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.
+     */
+    getMetadata(snapId: string): SnapRegistryMetadata | null;
+}
+export {};
+//# sourceMappingURL=SnapRegistryController.d.cts.map

package/dist/snaps/registry/SnapRegistryController.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SnapRegistryController.d.cts","sourceRoot":"","sources":["../../../src/snaps/registry/SnapRegistryController.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,wBAAwB,EACxB,0BAA0B,EAC3B,kCAAkC;AACnC,OAAO,EAAE,cAAc,EAAE,kCAAkC;AAC3D,OAAO,KAAK,EAAE,SAAS,EAAE,4BAA4B;AACrD,OAAO,KAAK,EACV,qBAAqB,EAEtB,iCAAiC;AAIlC,OAAO,KAAK,EAAE,GAAG,EAAE,WAAW,EAAE,aAAa,EAAE,wBAAwB;AASvE,OAAO,KAAK,EAAE,mCAAmC,EAAE,yDAAqD;AACxG,OAAO,KAAK,EAEV,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EACnB,oBAAgB;AAYjB,KAAK,oBAAoB,GAAG;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,WAAW,GAAG,QAAQ,CAAC;IAC7B,OAAO,EAAE,aAAa,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG;IACvC,SAAS,EAAE,+BAA+B,CAAC;IAC3C,KAAK,CAAC,EAAE,2BAA2B,CAAC;IACpC,aAAa,CAAC,EAAE,OAAO,KAAK,CAAC;IAC7B,GAAG,CAAC,EAAE,oBAAoB,CAAC;IAC3B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,SAAS,CAAC,EAAE,GAAG,CAAC;IAChB,YAAY,EAAE,YAAY,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,oCAAoC,GAAG,wBAAwB,CACzE,OAAO,cAAc,EACrB,2BAA2B,CAC5B,CAAC;AAEF,MAAM,MAAM,6BAA6B,GACrC,oCAAoC,GACpC,mCAAmC,CAAC;AAExC,MAAM,MAAM,sCAAsC,GAAG,0BAA0B,CAC7E,OAAO,cAAc,EACrB,2BAA2B,CAC5B,CAAC;AAEF,MAAM,MAAM,4BAA4B,GACtC,sCAAsC,CAAC;AAEzC,MAAM,MAAM,+BAA+B,GAAG,SAAS,CACrD,OAAO,cAAc,EACrB,6BAA6B,EAC7B,4BAA4B,CAC7B,CAAC;AAEF,MAAM,MAAM,2BAA2B,GAAG;IACxC,QAAQ,EAAE,qBAAqB,GAAG,IAAI,CAAC;IACvC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,mBAAmB,EAAE,OAAO,CAAC;CAC9B,CAAC;AAEF,QAAA,MAAM,cAAc,2BAA2B,CAAC;AAgBhD,qBAAa,sBAAuB,SAAQ,cAAc,CACxD,OAAO,cAAc,EACrB,2BAA2B,EAC3B,+BAA+B,CAChC;;gBAea,EACV,SAAS,EACT,KAAK,EACL,GAGC,EACD,SAA8B,EAC9B,YAAY,EACZ,aAAgD,EAChD,oBAAyD,EACzD,sBAA6B,GAC9B,EAAE,0BAA0B;IAwD7B;;;;OAIG;IACG,aAAa;IAgHb,GAAG,CACP,KAAK,EAAE,mBAAmB,GACzB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAW9C;;;;;;;OAOG;IACG,cAAc,CAClB,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,WAAW,EACzB,OAAO,UAAQ,GACd,OAAO,CAAC,WAAW,CAAC;IA8CvB;;;;;;OAMG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,oBAAoB,GAAG,IAAI;CAyCzD"}

package/dist/snaps/registry/SnapRegistryController.d.mts

@@ -0,0 +1,67 @@
+import type { ControllerGetStateAction, ControllerStateChangeEvent } from "@metamask/base-controller";
+import { BaseController } from "@metamask/base-controller";
+import type { Messenger } from "@metamask/messenger";
+import type { SnapsRegistryDatabase } from "@metamask/snaps-registry";
+import type { Hex, SemVerRange, SemVerVersion } from "@metamask/utils";
+import type { SnapRegistryControllerMethodActions } from "./SnapRegistryController-method-action-types.mjs";
+import type { SnapRegistryMetadata, SnapRegistryRequest, SnapRegistryResult } from "./types.mjs";
+type JsonSnapsRegistryUrl = {
+    registry: string;
+    signature: string;
+};
+export type ClientConfig = {
+    type: 'extension' | 'mobile';
+    version: SemVerVersion;
+};
+export type SnapRegistryControllerArgs = {
+    messenger: SnapRegistryControllerMessenger;
+    state?: SnapRegistryControllerState;
+    fetchFunction?: typeof fetch;
+    url?: JsonSnapsRegistryUrl;
+    recentFetchThreshold?: number;
+    refetchOnAllowlistMiss?: boolean;
+    publicKey?: Hex;
+    clientConfig: ClientConfig;
+};
+export type SnapRegistryControllerGetStateAction = ControllerGetStateAction<typeof controllerName, SnapRegistryControllerState>;
+export type SnapRegistryControllerActions = SnapRegistryControllerGetStateAction | SnapRegistryControllerMethodActions;
+export type SnapRegistryControllerStateChangeEvent = ControllerStateChangeEvent<typeof controllerName, SnapRegistryControllerState>;
+export type SnapRegistryControllerEvents = SnapRegistryControllerStateChangeEvent;
+export type SnapRegistryControllerMessenger = Messenger<typeof controllerName, SnapRegistryControllerActions, SnapRegistryControllerEvents>;
+export type SnapRegistryControllerState = {
+    database: SnapsRegistryDatabase | null;
+    signature: string | null;
+    lastUpdated: number | null;
+    databaseUnavailable: boolean;
+};
+declare const controllerName = "SnapRegistryController";
+export declare class SnapRegistryController extends BaseController<typeof controllerName, SnapRegistryControllerState, SnapRegistryControllerMessenger> {
+    #private;
+    constructor({ messenger, state, url, publicKey, clientConfig, fetchFunction, recentFetchThreshold, refetchOnAllowlistMiss, }: SnapRegistryControllerArgs);
+    /**
+     * Triggers an update of the registry database.
+     *
+     * If an existing update is in progress this function will await that update.
+     */
+    requestUpdate(): Promise<void>;
+    get(snaps: SnapRegistryRequest): Promise<Record<string, SnapRegistryResult>>;
+    /**
+     * Find an allowlisted version within a specified version range. Otherwise return the version range itself.
+     *
+     * @param snapId - The ID of the snap we are trying to resolve a version for.
+     * @param versionRange - The version range.
+     * @param refetch - An optional flag used to determine if we are refetching the registry.
+     * @returns An allowlisted version within the specified version range if available otherwise returns the input version range.
+     */
+    resolveVersion(snapId: string, versionRange: SemVerRange, refetch?: boolean): Promise<SemVerRange>;
+    /**
+     * Get metadata for the given snap ID, if available, without updating registry.
+     *
+     * @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.
+     */
+    getMetadata(snapId: string): SnapRegistryMetadata | null;
+}
+export {};
+//# sourceMappingURL=SnapRegistryController.d.mts.map

package/dist/snaps/registry/SnapRegistryController.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SnapRegistryController.d.mts","sourceRoot":"","sources":["../../../src/snaps/registry/SnapRegistryController.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,wBAAwB,EACxB,0BAA0B,EAC3B,kCAAkC;AACnC,OAAO,EAAE,cAAc,EAAE,kCAAkC;AAC3D,OAAO,KAAK,EAAE,SAAS,EAAE,4BAA4B;AACrD,OAAO,KAAK,EACV,qBAAqB,EAEtB,iCAAiC;AAIlC,OAAO,KAAK,EAAE,GAAG,EAAE,WAAW,EAAE,aAAa,EAAE,wBAAwB;AASvE,OAAO,KAAK,EAAE,mCAAmC,EAAE,yDAAqD;AACxG,OAAO,KAAK,EAEV,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EACnB,oBAAgB;AAYjB,KAAK,oBAAoB,GAAG;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,WAAW,GAAG,QAAQ,CAAC;IAC7B,OAAO,EAAE,aAAa,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG;IACvC,SAAS,EAAE,+BAA+B,CAAC;IAC3C,KAAK,CAAC,EAAE,2BAA2B,CAAC;IACpC,aAAa,CAAC,EAAE,OAAO,KAAK,CAAC;IAC7B,GAAG,CAAC,EAAE,oBAAoB,CAAC;IAC3B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,SAAS,CAAC,EAAE,GAAG,CAAC;IAChB,YAAY,EAAE,YAAY,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,oCAAoC,GAAG,wBAAwB,CACzE,OAAO,cAAc,EACrB,2BAA2B,CAC5B,CAAC;AAEF,MAAM,MAAM,6BAA6B,GACrC,oCAAoC,GACpC,mCAAmC,CAAC;AAExC,MAAM,MAAM,sCAAsC,GAAG,0BAA0B,CAC7E,OAAO,cAAc,EACrB,2BAA2B,CAC5B,CAAC;AAEF,MAAM,MAAM,4BAA4B,GACtC,sCAAsC,CAAC;AAEzC,MAAM,MAAM,+BAA+B,GAAG,SAAS,CACrD,OAAO,cAAc,EACrB,6BAA6B,EAC7B,4BAA4B,CAC7B,CAAC;AAEF,MAAM,MAAM,2BAA2B,GAAG;IACxC,QAAQ,EAAE,qBAAqB,GAAG,IAAI,CAAC;IACvC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,mBAAmB,EAAE,OAAO,CAAC;CAC9B,CAAC;AAEF,QAAA,MAAM,cAAc,2BAA2B,CAAC;AAgBhD,qBAAa,sBAAuB,SAAQ,cAAc,CACxD,OAAO,cAAc,EACrB,2BAA2B,EAC3B,+BAA+B,CAChC;;gBAea,EACV,SAAS,EACT,KAAK,EACL,GAGC,EACD,SAA8B,EAC9B,YAAY,EACZ,aAAgD,EAChD,oBAAyD,EACzD,sBAA6B,GAC9B,EAAE,0BAA0B;IAwD7B;;;;OAIG;IACG,aAAa;IAgHb,GAAG,CACP,KAAK,EAAE,mBAAmB,GACzB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAW9C;;;;;;;OAOG;IACG,cAAc,CAClB,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,WAAW,EACzB,OAAO,UAAQ,GACd,OAAO,CAAC,WAAW,CAAC;IA8CvB;;;;;;OAMG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,oBAAoB,GAAG,IAAI;CAyCzD"}