@metamask/ramps-controller 1.0.0 → 2.1.0

package/dist/RequestCache.cjs

@@ -0,0 +1,98 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createErrorState = exports.createSuccessState = exports.createLoadingState = exports.isCacheExpired = exports.createCacheKey = exports.DEFAULT_REQUEST_CACHE_MAX_SIZE = exports.DEFAULT_REQUEST_CACHE_TTL = exports.RequestStatus = void 0;
+/**
+ * Status of a cached request.
+ */
+var RequestStatus;
+(function (RequestStatus) {
+    RequestStatus["IDLE"] = "idle";
+    RequestStatus["LOADING"] = "loading";
+    RequestStatus["SUCCESS"] = "success";
+    RequestStatus["ERROR"] = "error";
+})(RequestStatus || (exports.RequestStatus = RequestStatus = {}));
+/**
+ * Default TTL for cached requests in milliseconds (15 minutes).
+ */
+exports.DEFAULT_REQUEST_CACHE_TTL = 15 * 60 * 1000;
+/**
+ * Default maximum number of entries in the request cache.
+ */
+exports.DEFAULT_REQUEST_CACHE_MAX_SIZE = 250;
+/**
+ * Creates a cache key from a method name and parameters.
+ *
+ * @param method - The method name.
+ * @param params - The parameters passed to the method.
+ * @returns A unique cache key string.
+ */
+function createCacheKey(method, params) {
+    return `${method}:${JSON.stringify(params)}`;
+}
+exports.createCacheKey = createCacheKey;
+/**
+ * Checks if a cached request has expired based on TTL.
+ *
+ * @param requestState - The cached request state.
+ * @param ttl - Time to live in milliseconds.
+ * @returns True if the cache entry has expired.
+ */
+function isCacheExpired(requestState, ttl = exports.DEFAULT_REQUEST_CACHE_TTL) {
+    if (requestState.status !== RequestStatus.SUCCESS) {
+        return true;
+    }
+    const now = Date.now();
+    return now - requestState.timestamp > ttl;
+}
+exports.isCacheExpired = isCacheExpired;
+/**
+ * Creates an initial loading state for a request.
+ *
+ * @returns A new RequestState in loading status.
+ */
+function createLoadingState() {
+    const now = Date.now();
+    return {
+        status: RequestStatus.LOADING,
+        data: null,
+        error: null,
+        timestamp: now,
+        lastFetchedAt: now,
+    };
+}
+exports.createLoadingState = createLoadingState;
+/**
+ * Creates a success state for a request.
+ *
+ * @param data - The data returned by the request.
+ * @param lastFetchedAt - When the fetch started.
+ * @returns A new RequestState in success status.
+ */
+function createSuccessState(data, lastFetchedAt) {
+    return {
+        status: RequestStatus.SUCCESS,
+        data,
+        error: null,
+        timestamp: Date.now(),
+        lastFetchedAt,
+    };
+}
+exports.createSuccessState = createSuccessState;
+/**
+ * Creates an error state for a request.
+ *
+ * @param error - The error message.
+ * @param lastFetchedAt - When the fetch started.
+ * @returns A new RequestState in error status.
+ */
+function createErrorState(error, lastFetchedAt) {
+    return {
+        status: RequestStatus.ERROR,
+        data: null,
+        error,
+        timestamp: Date.now(),
+        lastFetchedAt,
+    };
+}
+exports.createErrorState = createErrorState;
+//# sourceMappingURL=RequestCache.cjs.map

package/dist/RequestCache.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"RequestCache.cjs","sourceRoot":"","sources":["../src/RequestCache.ts"],"names":[],"mappings":";;;AAEA;;GAEG;AACH,IAAY,aAKX;AALD,WAAY,aAAa;IACvB,8BAAa,CAAA;IACb,oCAAmB,CAAA;IACnB,oCAAmB,CAAA;IACnB,gCAAe,CAAA;AACjB,CAAC,EALW,aAAa,6BAAb,aAAa,QAKxB;AAwBD;;GAEG;AACU,QAAA,yBAAyB,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAExD;;GAEG;AACU,QAAA,8BAA8B,GAAG,GAAG,CAAC;AAElD;;;;;;GAMG;AACH,SAAgB,cAAc,CAAC,MAAc,EAAE,MAAiB;IAC9D,OAAO,GAAG,MAAM,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;AAC/C,CAAC;AAFD,wCAEC;AAED;;;;;;GAMG;AACH,SAAgB,cAAc,CAC5B,YAA0B,EAC1B,MAAc,iCAAyB;IAEvC,IAAI,YAAY,CAAC,MAAM,KAAK,aAAa,CAAC,OAAO,EAAE,CAAC;QAClD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,OAAO,GAAG,GAAG,YAAY,CAAC,SAAS,GAAG,GAAG,CAAC;AAC5C,CAAC;AATD,wCASC;AAED;;;;GAIG;AACH,SAAgB,kBAAkB;IAChC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,OAAO;QACL,MAAM,EAAE,aAAa,CAAC,OAAO;QAC7B,IAAI,EAAE,IAAI;QACV,KAAK,EAAE,IAAI;QACX,SAAS,EAAE,GAAG;QACd,aAAa,EAAE,GAAG;KACnB,CAAC;AACJ,CAAC;AATD,gDASC;AAED;;;;;;GAMG;AACH,SAAgB,kBAAkB,CAChC,IAAU,EACV,aAAqB;IAErB,OAAO;QACL,MAAM,EAAE,aAAa,CAAC,OAAO;QAC7B,IAAI;QACJ,KAAK,EAAE,IAAI;QACX,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;QACrB,aAAa;KACd,CAAC;AACJ,CAAC;AAXD,gDAWC;AAED;;;;;;GAMG;AACH,SAAgB,gBAAgB,CAC9B,KAAa,EACb,aAAqB;IAErB,OAAO;QACL,MAAM,EAAE,aAAa,CAAC,KAAK;QAC3B,IAAI,EAAE,IAAI;QACV,KAAK;QACL,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;QACrB,aAAa;KACd,CAAC;AACJ,CAAC;AAXD,4CAWC","sourcesContent":["import type { Json } from '@metamask/utils';\n\n/**\n * Status of a cached request.\n */\nexport enum RequestStatus {\n  IDLE = 'idle',\n  LOADING = 'loading',\n  SUCCESS = 'success',\n  ERROR = 'error',\n}\n\n/**\n * State of a single cached request.\n * All properties must be JSON-serializable to satisfy StateConstraint.\n */\nexport type RequestState = {\n  /** Current status of the request */\n  status: `${RequestStatus}`;\n  /** The data returned by the request, if successful */\n  data: Json | null;\n  /** Error message if the request failed */\n  error: string | null;\n  /** Timestamp when the request completed (for TTL calculation) */\n  timestamp: number;\n  /** Timestamp when the fetch started */\n  lastFetchedAt: number;\n};\n\n/**\n * Cache of request states, keyed by cache key.\n */\nexport type RequestCache = Record<string, RequestState>;\n\n/**\n * Default TTL for cached requests in milliseconds (15 minutes).\n */\nexport const DEFAULT_REQUEST_CACHE_TTL = 15 * 60 * 1000;\n\n/**\n * Default maximum number of entries in the request cache.\n */\nexport const DEFAULT_REQUEST_CACHE_MAX_SIZE = 250;\n\n/**\n * Creates a cache key from a method name and parameters.\n *\n * @param method - The method name.\n * @param params - The parameters passed to the method.\n * @returns A unique cache key string.\n */\nexport function createCacheKey(method: string, params: unknown[]): string {\n  return `${method}:${JSON.stringify(params)}`;\n}\n\n/**\n * Checks if a cached request has expired based on TTL.\n *\n * @param requestState - The cached request state.\n * @param ttl - Time to live in milliseconds.\n * @returns True if the cache entry has expired.\n */\nexport function isCacheExpired(\n  requestState: RequestState,\n  ttl: number = DEFAULT_REQUEST_CACHE_TTL,\n): boolean {\n  if (requestState.status !== RequestStatus.SUCCESS) {\n    return true;\n  }\n  const now = Date.now();\n  return now - requestState.timestamp > ttl;\n}\n\n/**\n * Creates an initial loading state for a request.\n *\n * @returns A new RequestState in loading status.\n */\nexport function createLoadingState(): RequestState {\n  const now = Date.now();\n  return {\n    status: RequestStatus.LOADING,\n    data: null,\n    error: null,\n    timestamp: now,\n    lastFetchedAt: now,\n  };\n}\n\n/**\n * Creates a success state for a request.\n *\n * @param data - The data returned by the request.\n * @param lastFetchedAt - When the fetch started.\n * @returns A new RequestState in success status.\n */\nexport function createSuccessState(\n  data: Json,\n  lastFetchedAt: number,\n): RequestState {\n  return {\n    status: RequestStatus.SUCCESS,\n    data,\n    error: null,\n    timestamp: Date.now(),\n    lastFetchedAt,\n  };\n}\n\n/**\n * Creates an error state for a request.\n *\n * @param error - The error message.\n * @param lastFetchedAt - When the fetch started.\n * @returns A new RequestState in error status.\n */\nexport function createErrorState(\n  error: string,\n  lastFetchedAt: number,\n): RequestState {\n  return {\n    status: RequestStatus.ERROR,\n    data: null,\n    error,\n    timestamp: Date.now(),\n    lastFetchedAt,\n  };\n}\n\n/**\n * Options for executing a cached request.\n */\nexport type ExecuteRequestOptions = {\n  /** Force a refresh even if cached data exists */\n  forceRefresh?: boolean;\n  /** Custom TTL for this request in milliseconds */\n  ttl?: number;\n};\n\n/**\n * Represents a pending request with its promise and abort controller.\n */\nexport type PendingRequest<TResult = unknown> = {\n  promise: Promise<TResult>;\n  abortController: AbortController;\n};\n"]}

package/dist/RequestCache.d.cts

@@ -0,0 +1,93 @@
+import type { Json } from "@metamask/utils";
+/**
+ * Status of a cached request.
+ */
+export declare enum RequestStatus {
+    IDLE = "idle",
+    LOADING = "loading",
+    SUCCESS = "success",
+    ERROR = "error"
+}
+/**
+ * State of a single cached request.
+ * All properties must be JSON-serializable to satisfy StateConstraint.
+ */
+export type RequestState = {
+    /** Current status of the request */
+    status: `${RequestStatus}`;
+    /** The data returned by the request, if successful */
+    data: Json | null;
+    /** Error message if the request failed */
+    error: string | null;
+    /** Timestamp when the request completed (for TTL calculation) */
+    timestamp: number;
+    /** Timestamp when the fetch started */
+    lastFetchedAt: number;
+};
+/**
+ * Cache of request states, keyed by cache key.
+ */
+export type RequestCache = Record<string, RequestState>;
+/**
+ * Default TTL for cached requests in milliseconds (15 minutes).
+ */
+export declare const DEFAULT_REQUEST_CACHE_TTL: number;
+/**
+ * Default maximum number of entries in the request cache.
+ */
+export declare const DEFAULT_REQUEST_CACHE_MAX_SIZE = 250;
+/**
+ * Creates a cache key from a method name and parameters.
+ *
+ * @param method - The method name.
+ * @param params - The parameters passed to the method.
+ * @returns A unique cache key string.
+ */
+export declare function createCacheKey(method: string, params: unknown[]): string;
+/**
+ * Checks if a cached request has expired based on TTL.
+ *
+ * @param requestState - The cached request state.
+ * @param ttl - Time to live in milliseconds.
+ * @returns True if the cache entry has expired.
+ */
+export declare function isCacheExpired(requestState: RequestState, ttl?: number): boolean;
+/**
+ * Creates an initial loading state for a request.
+ *
+ * @returns A new RequestState in loading status.
+ */
+export declare function createLoadingState(): RequestState;
+/**
+ * Creates a success state for a request.
+ *
+ * @param data - The data returned by the request.
+ * @param lastFetchedAt - When the fetch started.
+ * @returns A new RequestState in success status.
+ */
+export declare function createSuccessState(data: Json, lastFetchedAt: number): RequestState;
+/**
+ * Creates an error state for a request.
+ *
+ * @param error - The error message.
+ * @param lastFetchedAt - When the fetch started.
+ * @returns A new RequestState in error status.
+ */
+export declare function createErrorState(error: string, lastFetchedAt: number): RequestState;
+/**
+ * Options for executing a cached request.
+ */
+export type ExecuteRequestOptions = {
+    /** Force a refresh even if cached data exists */
+    forceRefresh?: boolean;
+    /** Custom TTL for this request in milliseconds */
+    ttl?: number;
+};
+/**
+ * Represents a pending request with its promise and abort controller.
+ */
+export type PendingRequest<TResult = unknown> = {
+    promise: Promise<TResult>;
+    abortController: AbortController;
+};
+//# sourceMappingURL=RequestCache.d.cts.map

package/dist/RequestCache.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RequestCache.d.cts","sourceRoot":"","sources":["../src/RequestCache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,wBAAwB;AAE5C;;GAEG;AACH,oBAAY,aAAa;IACvB,IAAI,SAAS;IACb,OAAO,YAAY;IACnB,OAAO,YAAY;IACnB,KAAK,UAAU;CAChB;AAED;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,oCAAoC;IACpC,MAAM,EAAE,GAAG,aAAa,EAAE,CAAC;IAC3B,sDAAsD;IACtD,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;IAClB,0CAA0C;IAC1C,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,iEAAiE;IACjE,SAAS,EAAE,MAAM,CAAC;IAClB,uCAAuC;IACvC,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;AAExD;;GAEG;AACH,eAAO,MAAM,yBAAyB,QAAiB,CAAC;AAExD;;GAEG;AACH,eAAO,MAAM,8BAA8B,MAAM,CAAC;AAElD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,CAExE;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,YAAY,EAAE,YAAY,EAC1B,GAAG,GAAE,MAAkC,GACtC,OAAO,CAMT;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,YAAY,CASjD;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,IAAI,EACV,aAAa,EAAE,MAAM,GACpB,YAAY,CAQd;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,EACb,aAAa,EAAE,MAAM,GACpB,YAAY,CAQd;AAED;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC,iDAAiD;IACjD,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,kDAAkD;IAClD,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,cAAc,CAAC,OAAO,GAAG,OAAO,IAAI;IAC9C,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1B,eAAe,EAAE,eAAe,CAAC;CAClC,CAAC"}

package/dist/RequestCache.d.mts

@@ -0,0 +1,93 @@
+import type { Json } from "@metamask/utils";
+/**
+ * Status of a cached request.
+ */
+export declare enum RequestStatus {
+    IDLE = "idle",
+    LOADING = "loading",
+    SUCCESS = "success",
+    ERROR = "error"
+}
+/**
+ * State of a single cached request.
+ * All properties must be JSON-serializable to satisfy StateConstraint.
+ */
+export type RequestState = {
+    /** Current status of the request */
+    status: `${RequestStatus}`;
+    /** The data returned by the request, if successful */
+    data: Json | null;
+    /** Error message if the request failed */
+    error: string | null;
+    /** Timestamp when the request completed (for TTL calculation) */
+    timestamp: number;
+    /** Timestamp when the fetch started */
+    lastFetchedAt: number;
+};
+/**
+ * Cache of request states, keyed by cache key.
+ */
+export type RequestCache = Record<string, RequestState>;
+/**
+ * Default TTL for cached requests in milliseconds (15 minutes).
+ */
+export declare const DEFAULT_REQUEST_CACHE_TTL: number;
+/**
+ * Default maximum number of entries in the request cache.
+ */
+export declare const DEFAULT_REQUEST_CACHE_MAX_SIZE = 250;
+/**
+ * Creates a cache key from a method name and parameters.
+ *
+ * @param method - The method name.
+ * @param params - The parameters passed to the method.
+ * @returns A unique cache key string.
+ */
+export declare function createCacheKey(method: string, params: unknown[]): string;
+/**
+ * Checks if a cached request has expired based on TTL.
+ *
+ * @param requestState - The cached request state.
+ * @param ttl - Time to live in milliseconds.
+ * @returns True if the cache entry has expired.
+ */
+export declare function isCacheExpired(requestState: RequestState, ttl?: number): boolean;
+/**
+ * Creates an initial loading state for a request.
+ *
+ * @returns A new RequestState in loading status.
+ */
+export declare function createLoadingState(): RequestState;
+/**
+ * Creates a success state for a request.
+ *
+ * @param data - The data returned by the request.
+ * @param lastFetchedAt - When the fetch started.
+ * @returns A new RequestState in success status.
+ */
+export declare function createSuccessState(data: Json, lastFetchedAt: number): RequestState;
+/**
+ * Creates an error state for a request.
+ *
+ * @param error - The error message.
+ * @param lastFetchedAt - When the fetch started.
+ * @returns A new RequestState in error status.
+ */
+export declare function createErrorState(error: string, lastFetchedAt: number): RequestState;
+/**
+ * Options for executing a cached request.
+ */
+export type ExecuteRequestOptions = {
+    /** Force a refresh even if cached data exists */
+    forceRefresh?: boolean;
+    /** Custom TTL for this request in milliseconds */
+    ttl?: number;
+};
+/**
+ * Represents a pending request with its promise and abort controller.
+ */
+export type PendingRequest<TResult = unknown> = {
+    promise: Promise<TResult>;
+    abortController: AbortController;
+};
+//# sourceMappingURL=RequestCache.d.mts.map

package/dist/RequestCache.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RequestCache.d.mts","sourceRoot":"","sources":["../src/RequestCache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,wBAAwB;AAE5C;;GAEG;AACH,oBAAY,aAAa;IACvB,IAAI,SAAS;IACb,OAAO,YAAY;IACnB,OAAO,YAAY;IACnB,KAAK,UAAU;CAChB;AAED;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,oCAAoC;IACpC,MAAM,EAAE,GAAG,aAAa,EAAE,CAAC;IAC3B,sDAAsD;IACtD,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;IAClB,0CAA0C;IAC1C,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,iEAAiE;IACjE,SAAS,EAAE,MAAM,CAAC;IAClB,uCAAuC;IACvC,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;AAExD;;GAEG;AACH,eAAO,MAAM,yBAAyB,QAAiB,CAAC;AAExD;;GAEG;AACH,eAAO,MAAM,8BAA8B,MAAM,CAAC;AAElD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,CAExE;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,YAAY,EAAE,YAAY,EAC1B,GAAG,GAAE,MAAkC,GACtC,OAAO,CAMT;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,YAAY,CASjD;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,IAAI,EACV,aAAa,EAAE,MAAM,GACpB,YAAY,CAQd;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,EACb,aAAa,EAAE,MAAM,GACpB,YAAY,CAQd;AAED;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC,iDAAiD;IACjD,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,kDAAkD;IAClD,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,cAAc,CAAC,OAAO,GAAG,OAAO,IAAI;IAC9C,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1B,eAAe,EAAE,eAAe,CAAC;CAClC,CAAC"}

package/dist/RequestCache.mjs

@@ -0,0 +1,90 @@
+/**
+ * Status of a cached request.
+ */
+export var RequestStatus;
+(function (RequestStatus) {
+    RequestStatus["IDLE"] = "idle";
+    RequestStatus["LOADING"] = "loading";
+    RequestStatus["SUCCESS"] = "success";
+    RequestStatus["ERROR"] = "error";
+})(RequestStatus || (RequestStatus = {}));
+/**
+ * Default TTL for cached requests in milliseconds (15 minutes).
+ */
+export const DEFAULT_REQUEST_CACHE_TTL = 15 * 60 * 1000;
+/**
+ * Default maximum number of entries in the request cache.
+ */
+export const DEFAULT_REQUEST_CACHE_MAX_SIZE = 250;
+/**
+ * Creates a cache key from a method name and parameters.
+ *
+ * @param method - The method name.
+ * @param params - The parameters passed to the method.
+ * @returns A unique cache key string.
+ */
+export function createCacheKey(method, params) {
+    return `${method}:${JSON.stringify(params)}`;
+}
+/**
+ * Checks if a cached request has expired based on TTL.
+ *
+ * @param requestState - The cached request state.
+ * @param ttl - Time to live in milliseconds.
+ * @returns True if the cache entry has expired.
+ */
+export function isCacheExpired(requestState, ttl = DEFAULT_REQUEST_CACHE_TTL) {
+    if (requestState.status !== RequestStatus.SUCCESS) {
+        return true;
+    }
+    const now = Date.now();
+    return now - requestState.timestamp > ttl;
+}
+/**
+ * Creates an initial loading state for a request.
+ *
+ * @returns A new RequestState in loading status.
+ */
+export function createLoadingState() {
+    const now = Date.now();
+    return {
+        status: RequestStatus.LOADING,
+        data: null,
+        error: null,
+        timestamp: now,
+        lastFetchedAt: now,
+    };
+}
+/**
+ * Creates a success state for a request.
+ *
+ * @param data - The data returned by the request.
+ * @param lastFetchedAt - When the fetch started.
+ * @returns A new RequestState in success status.
+ */
+export function createSuccessState(data, lastFetchedAt) {
+    return {
+        status: RequestStatus.SUCCESS,
+        data,
+        error: null,
+        timestamp: Date.now(),
+        lastFetchedAt,
+    };
+}
+/**
+ * Creates an error state for a request.
+ *
+ * @param error - The error message.
+ * @param lastFetchedAt - When the fetch started.
+ * @returns A new RequestState in error status.
+ */
+export function createErrorState(error, lastFetchedAt) {
+    return {
+        status: RequestStatus.ERROR,
+        data: null,
+        error,
+        timestamp: Date.now(),
+        lastFetchedAt,
+    };
+}
+//# sourceMappingURL=RequestCache.mjs.map

package/dist/RequestCache.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"RequestCache.mjs","sourceRoot":"","sources":["../src/RequestCache.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,CAAN,IAAY,aAKX;AALD,WAAY,aAAa;IACvB,8BAAa,CAAA;IACb,oCAAmB,CAAA;IACnB,oCAAmB,CAAA;IACnB,gCAAe,CAAA;AACjB,CAAC,EALW,aAAa,KAAb,aAAa,QAKxB;AAwBD;;GAEG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAExD;;GAEG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAG,GAAG,CAAC;AAElD;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,MAAc,EAAE,MAAiB;IAC9D,OAAO,GAAG,MAAM,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;AAC/C,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAC5B,YAA0B,EAC1B,MAAc,yBAAyB;IAEvC,IAAI,YAAY,CAAC,MAAM,KAAK,aAAa,CAAC,OAAO,EAAE,CAAC;QAClD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,OAAO,GAAG,GAAG,YAAY,CAAC,SAAS,GAAG,GAAG,CAAC;AAC5C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB;IAChC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,OAAO;QACL,MAAM,EAAE,aAAa,CAAC,OAAO;QAC7B,IAAI,EAAE,IAAI;QACV,KAAK,EAAE,IAAI;QACX,SAAS,EAAE,GAAG;QACd,aAAa,EAAE,GAAG;KACnB,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAChC,IAAU,EACV,aAAqB;IAErB,OAAO;QACL,MAAM,EAAE,aAAa,CAAC,OAAO;QAC7B,IAAI;QACJ,KAAK,EAAE,IAAI;QACX,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;QACrB,aAAa;KACd,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAC9B,KAAa,EACb,aAAqB;IAErB,OAAO;QACL,MAAM,EAAE,aAAa,CAAC,KAAK;QAC3B,IAAI,EAAE,IAAI;QACV,KAAK;QACL,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;QACrB,aAAa;KACd,CAAC;AACJ,CAAC","sourcesContent":["import type { Json } from '@metamask/utils';\n\n/**\n * Status of a cached request.\n */\nexport enum RequestStatus {\n  IDLE = 'idle',\n  LOADING = 'loading',\n  SUCCESS = 'success',\n  ERROR = 'error',\n}\n\n/**\n * State of a single cached request.\n * All properties must be JSON-serializable to satisfy StateConstraint.\n */\nexport type RequestState = {\n  /** Current status of the request */\n  status: `${RequestStatus}`;\n  /** The data returned by the request, if successful */\n  data: Json | null;\n  /** Error message if the request failed */\n  error: string | null;\n  /** Timestamp when the request completed (for TTL calculation) */\n  timestamp: number;\n  /** Timestamp when the fetch started */\n  lastFetchedAt: number;\n};\n\n/**\n * Cache of request states, keyed by cache key.\n */\nexport type RequestCache = Record<string, RequestState>;\n\n/**\n * Default TTL for cached requests in milliseconds (15 minutes).\n */\nexport const DEFAULT_REQUEST_CACHE_TTL = 15 * 60 * 1000;\n\n/**\n * Default maximum number of entries in the request cache.\n */\nexport const DEFAULT_REQUEST_CACHE_MAX_SIZE = 250;\n\n/**\n * Creates a cache key from a method name and parameters.\n *\n * @param method - The method name.\n * @param params - The parameters passed to the method.\n * @returns A unique cache key string.\n */\nexport function createCacheKey(method: string, params: unknown[]): string {\n  return `${method}:${JSON.stringify(params)}`;\n}\n\n/**\n * Checks if a cached request has expired based on TTL.\n *\n * @param requestState - The cached request state.\n * @param ttl - Time to live in milliseconds.\n * @returns True if the cache entry has expired.\n */\nexport function isCacheExpired(\n  requestState: RequestState,\n  ttl: number = DEFAULT_REQUEST_CACHE_TTL,\n): boolean {\n  if (requestState.status !== RequestStatus.SUCCESS) {\n    return true;\n  }\n  const now = Date.now();\n  return now - requestState.timestamp > ttl;\n}\n\n/**\n * Creates an initial loading state for a request.\n *\n * @returns A new RequestState in loading status.\n */\nexport function createLoadingState(): RequestState {\n  const now = Date.now();\n  return {\n    status: RequestStatus.LOADING,\n    data: null,\n    error: null,\n    timestamp: now,\n    lastFetchedAt: now,\n  };\n}\n\n/**\n * Creates a success state for a request.\n *\n * @param data - The data returned by the request.\n * @param lastFetchedAt - When the fetch started.\n * @returns A new RequestState in success status.\n */\nexport function createSuccessState(\n  data: Json,\n  lastFetchedAt: number,\n): RequestState {\n  return {\n    status: RequestStatus.SUCCESS,\n    data,\n    error: null,\n    timestamp: Date.now(),\n    lastFetchedAt,\n  };\n}\n\n/**\n * Creates an error state for a request.\n *\n * @param error - The error message.\n * @param lastFetchedAt - When the fetch started.\n * @returns A new RequestState in error status.\n */\nexport function createErrorState(\n  error: string,\n  lastFetchedAt: number,\n): RequestState {\n  return {\n    status: RequestStatus.ERROR,\n    data: null,\n    error,\n    timestamp: Date.now(),\n    lastFetchedAt,\n  };\n}\n\n/**\n * Options for executing a cached request.\n */\nexport type ExecuteRequestOptions = {\n  /** Force a refresh even if cached data exists */\n  forceRefresh?: boolean;\n  /** Custom TTL for this request in milliseconds */\n  ttl?: number;\n};\n\n/**\n * Represents a pending request with its promise and abort controller.\n */\nexport type PendingRequest<TResult = unknown> = {\n  promise: Promise<TResult>;\n  abortController: AbortController;\n};\n"]}

package/dist/index.cjs

@@ -1,10 +1,23 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.OnRampEnvironment = exports.OnRampService = exports.getDefaultRampsControllerState = exports.RampsController = void 0;
+exports.createRequestSelector = exports.createErrorState = exports.createSuccessState = exports.createLoadingState = exports.isCacheExpired = exports.createCacheKey = exports.DEFAULT_REQUEST_CACHE_MAX_SIZE = exports.DEFAULT_REQUEST_CACHE_TTL = exports.RequestStatus = exports.RAMPS_SDK_VERSION = exports.RampsApiService = exports.RampsEnvironment = exports.RampsService = exports.getDefaultRampsControllerState = exports.RampsController = void 0;
 var RampsController_1 = require("./RampsController.cjs");
 Object.defineProperty(exports, "RampsController", { enumerable: true, get: function () { return RampsController_1.RampsController; } });
 Object.defineProperty(exports, "getDefaultRampsControllerState", { enumerable: true, get: function () { return RampsController_1.getDefaultRampsControllerState; } });
-var OnRampService_1 = require("./OnRampService.cjs");
-Object.defineProperty(exports, "OnRampService", { enumerable: true, get: function () { return OnRampService_1.OnRampService; } });
-Object.defineProperty(exports, "OnRampEnvironment", { enumerable: true, get: function () { return OnRampService_1.OnRampEnvironment; } });
+var RampsService_1 = require("./RampsService.cjs");
+Object.defineProperty(exports, "RampsService", { enumerable: true, get: function () { return RampsService_1.RampsService; } });
+Object.defineProperty(exports, "RampsEnvironment", { enumerable: true, get: function () { return RampsService_1.RampsEnvironment; } });
+Object.defineProperty(exports, "RampsApiService", { enumerable: true, get: function () { return RampsService_1.RampsApiService; } });
+Object.defineProperty(exports, "RAMPS_SDK_VERSION", { enumerable: true, get: function () { return RampsService_1.RAMPS_SDK_VERSION; } });
+var RequestCache_1 = require("./RequestCache.cjs");
+Object.defineProperty(exports, "RequestStatus", { enumerable: true, get: function () { return RequestCache_1.RequestStatus; } });
+Object.defineProperty(exports, "DEFAULT_REQUEST_CACHE_TTL", { enumerable: true, get: function () { return RequestCache_1.DEFAULT_REQUEST_CACHE_TTL; } });
+Object.defineProperty(exports, "DEFAULT_REQUEST_CACHE_MAX_SIZE", { enumerable: true, get: function () { return RequestCache_1.DEFAULT_REQUEST_CACHE_MAX_SIZE; } });
+Object.defineProperty(exports, "createCacheKey", { enumerable: true, get: function () { return RequestCache_1.createCacheKey; } });
+Object.defineProperty(exports, "isCacheExpired", { enumerable: true, get: function () { return RequestCache_1.isCacheExpired; } });
+Object.defineProperty(exports, "createLoadingState", { enumerable: true, get: function () { return RequestCache_1.createLoadingState; } });
+Object.defineProperty(exports, "createSuccessState", { enumerable: true, get: function () { return RequestCache_1.createSuccessState; } });
+Object.defineProperty(exports, "createErrorState", { enumerable: true, get: function () { return RequestCache_1.createErrorState; } });
+var selectors_1 = require("./selectors.cjs");
+Object.defineProperty(exports, "createRequestSelector", { enumerable: true, get: function () { return selectors_1.createRequestSelector; } });
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAQA,yDAG2B;AAFzB,kHAAA,eAAe,OAAA;AACf,iIAAA,8BAA8B,OAAA;AAOhC,qDAAmE;AAA1D,8GAAA,aAAa,OAAA;AAAE,kHAAA,iBAAiB,OAAA","sourcesContent":["export type {\n  RampsControllerActions,\n  RampsControllerEvents,\n  RampsControllerGetStateAction,\n  RampsControllerMessenger,\n  RampsControllerState,\n  RampsControllerStateChangeEvent,\n} from './RampsController';\nexport {\n  RampsController,\n  getDefaultRampsControllerState,\n} from './RampsController';\nexport type {\n  OnRampServiceActions,\n  OnRampServiceEvents,\n  OnRampServiceMessenger,\n} from './OnRampService';\nexport { OnRampService, OnRampEnvironment } from './OnRampService';\nexport type { OnRampServiceGetGeolocationAction } from './OnRampService-method-action-types';\n"]}
+{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AASA,yDAG2B;AAFzB,kHAAA,eAAe,OAAA;AACf,iIAAA,8BAA8B,OAAA;AAWhC,mDAKwB;AAJtB,4GAAA,YAAY,OAAA;AACZ,gHAAA,gBAAgB,OAAA;AAChB,+GAAA,eAAe,OAAA;AACf,iHAAA,iBAAiB,OAAA;AAanB,mDASwB;AARtB,6GAAA,aAAa,OAAA;AACb,yHAAA,yBAAyB,OAAA;AACzB,8HAAA,8BAA8B,OAAA;AAC9B,8GAAA,cAAc,OAAA;AACd,8GAAA,cAAc,OAAA;AACd,kHAAA,kBAAkB,OAAA;AAClB,kHAAA,kBAAkB,OAAA;AAClB,gHAAA,gBAAgB,OAAA;AAGlB,6CAAoD;AAA3C,kHAAA,qBAAqB,OAAA","sourcesContent":["export type {\n  RampsControllerActions,\n  RampsControllerEvents,\n  RampsControllerGetStateAction,\n  RampsControllerMessenger,\n  RampsControllerState,\n  RampsControllerStateChangeEvent,\n  RampsControllerOptions,\n} from './RampsController';\nexport {\n  RampsController,\n  getDefaultRampsControllerState,\n} from './RampsController';\nexport type {\n  RampsServiceActions,\n  RampsServiceEvents,\n  RampsServiceMessenger,\n  Country,\n  State,\n  Eligibility,\n  CountryPhone,\n} from './RampsService';\nexport {\n  RampsService,\n  RampsEnvironment,\n  RampsApiService,\n  RAMPS_SDK_VERSION,\n} from './RampsService';\nexport type {\n  RampsServiceGetGeolocationAction,\n  RampsServiceGetCountriesAction,\n  RampsServiceGetEligibilityAction,\n} from './RampsService-method-action-types';\nexport type {\n  RequestCache,\n  RequestState,\n  ExecuteRequestOptions,\n  PendingRequest,\n} from './RequestCache';\nexport {\n  RequestStatus,\n  DEFAULT_REQUEST_CACHE_TTL,\n  DEFAULT_REQUEST_CACHE_MAX_SIZE,\n  createCacheKey,\n  isCacheExpired,\n  createLoadingState,\n  createSuccessState,\n  createErrorState,\n} from './RequestCache';\nexport type { RequestSelectorResult } from './selectors';\nexport { createRequestSelector } from './selectors';\n"]}

package/dist/index.d.cts

@@ -1,6 +1,10 @@
-export type { RampsControllerActions, RampsControllerEvents, RampsControllerGetStateAction, RampsControllerMessenger, RampsControllerState, RampsControllerStateChangeEvent, } from "./RampsController.cjs";
+export type { RampsControllerActions, RampsControllerEvents, RampsControllerGetStateAction, RampsControllerMessenger, RampsControllerState, RampsControllerStateChangeEvent, RampsControllerOptions, } from "./RampsController.cjs";
 export { RampsController, getDefaultRampsControllerState, } from "./RampsController.cjs";
-export type { OnRampServiceActions, OnRampServiceEvents, OnRampServiceMessenger, } from "./OnRampService.cjs";
-export { OnRampService, OnRampEnvironment } from "./OnRampService.cjs";
-export type { OnRampServiceGetGeolocationAction } from "./OnRampService-method-action-types.cjs";
+export type { RampsServiceActions, RampsServiceEvents, RampsServiceMessenger, Country, State, Eligibility, CountryPhone, } from "./RampsService.cjs";
+export { RampsService, RampsEnvironment, RampsApiService, RAMPS_SDK_VERSION, } from "./RampsService.cjs";
+export type { RampsServiceGetGeolocationAction, RampsServiceGetCountriesAction, RampsServiceGetEligibilityAction, } from "./RampsService-method-action-types.cjs";
+export type { RequestCache, RequestState, ExecuteRequestOptions, PendingRequest, } from "./RequestCache.cjs";
+export { RequestStatus, DEFAULT_REQUEST_CACHE_TTL, DEFAULT_REQUEST_CACHE_MAX_SIZE, createCacheKey, isCacheExpired, createLoadingState, createSuccessState, createErrorState, } from "./RequestCache.cjs";
+export type { RequestSelectorResult } from "./selectors.cjs";
+export { createRequestSelector } from "./selectors.cjs";
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,sBAAsB,EACtB,qBAAqB,EACrB,6BAA6B,EAC7B,wBAAwB,EACxB,oBAAoB,EACpB,+BAA+B,GAChC,8BAA0B;AAC3B,OAAO,EACL,eAAe,EACf,8BAA8B,GAC/B,8BAA0B;AAC3B,YAAY,EACV,oBAAoB,EACpB,mBAAmB,EACnB,sBAAsB,GACvB,4BAAwB;AACzB,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,4BAAwB;AACnE,YAAY,EAAE,iCAAiC,EAAE,gDAA4C"}
+{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,sBAAsB,EACtB,qBAAqB,EACrB,6BAA6B,EAC7B,wBAAwB,EACxB,oBAAoB,EACpB,+BAA+B,EAC/B,sBAAsB,GACvB,8BAA0B;AAC3B,OAAO,EACL,eAAe,EACf,8BAA8B,GAC/B,8BAA0B;AAC3B,YAAY,EACV,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,EACrB,OAAO,EACP,KAAK,EACL,WAAW,EACX,YAAY,GACb,2BAAuB;AACxB,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,iBAAiB,GAClB,2BAAuB;AACxB,YAAY,EACV,gCAAgC,EAChC,8BAA8B,EAC9B,gCAAgC,GACjC,+CAA2C;AAC5C,YAAY,EACV,YAAY,EACZ,YAAY,EACZ,qBAAqB,EACrB,cAAc,GACf,2BAAuB;AACxB,OAAO,EACL,aAAa,EACb,yBAAyB,EACzB,8BAA8B,EAC9B,cAAc,EACd,cAAc,EACd,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,GACjB,2BAAuB;AACxB,YAAY,EAAE,qBAAqB,EAAE,wBAAoB;AACzD,OAAO,EAAE,qBAAqB,EAAE,wBAAoB"}

package/dist/index.d.mts

@@ -1,6 +1,10 @@
-export type { RampsControllerActions, RampsControllerEvents, RampsControllerGetStateAction, RampsControllerMessenger, RampsControllerState, RampsControllerStateChangeEvent, } from "./RampsController.mjs";
+export type { RampsControllerActions, RampsControllerEvents, RampsControllerGetStateAction, RampsControllerMessenger, RampsControllerState, RampsControllerStateChangeEvent, RampsControllerOptions, } from "./RampsController.mjs";
 export { RampsController, getDefaultRampsControllerState, } from "./RampsController.mjs";
-export type { OnRampServiceActions, OnRampServiceEvents, OnRampServiceMessenger, } from "./OnRampService.mjs";
-export { OnRampService, OnRampEnvironment } from "./OnRampService.mjs";
-export type { OnRampServiceGetGeolocationAction } from "./OnRampService-method-action-types.mjs";
+export type { RampsServiceActions, RampsServiceEvents, RampsServiceMessenger, Country, State, Eligibility, CountryPhone, } from "./RampsService.mjs";
+export { RampsService, RampsEnvironment, RampsApiService, RAMPS_SDK_VERSION, } from "./RampsService.mjs";
+export type { RampsServiceGetGeolocationAction, RampsServiceGetCountriesAction, RampsServiceGetEligibilityAction, } from "./RampsService-method-action-types.mjs";
+export type { RequestCache, RequestState, ExecuteRequestOptions, PendingRequest, } from "./RequestCache.mjs";
+export { RequestStatus, DEFAULT_REQUEST_CACHE_TTL, DEFAULT_REQUEST_CACHE_MAX_SIZE, createCacheKey, isCacheExpired, createLoadingState, createSuccessState, createErrorState, } from "./RequestCache.mjs";
+export type { RequestSelectorResult } from "./selectors.mjs";
+export { createRequestSelector } from "./selectors.mjs";
 //# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,sBAAsB,EACtB,qBAAqB,EACrB,6BAA6B,EAC7B,wBAAwB,EACxB,oBAAoB,EACpB,+BAA+B,GAChC,8BAA0B;AAC3B,OAAO,EACL,eAAe,EACf,8BAA8B,GAC/B,8BAA0B;AAC3B,YAAY,EACV,oBAAoB,EACpB,mBAAmB,EACnB,sBAAsB,GACvB,4BAAwB;AACzB,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,4BAAwB;AACnE,YAAY,EAAE,iCAAiC,EAAE,gDAA4C"}
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,sBAAsB,EACtB,qBAAqB,EACrB,6BAA6B,EAC7B,wBAAwB,EACxB,oBAAoB,EACpB,+BAA+B,EAC/B,sBAAsB,GACvB,8BAA0B;AAC3B,OAAO,EACL,eAAe,EACf,8BAA8B,GAC/B,8BAA0B;AAC3B,YAAY,EACV,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,EACrB,OAAO,EACP,KAAK,EACL,WAAW,EACX,YAAY,GACb,2BAAuB;AACxB,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,iBAAiB,GAClB,2BAAuB;AACxB,YAAY,EACV,gCAAgC,EAChC,8BAA8B,EAC9B,gCAAgC,GACjC,+CAA2C;AAC5C,YAAY,EACV,YAAY,EACZ,YAAY,EACZ,qBAAqB,EACrB,cAAc,GACf,2BAAuB;AACxB,OAAO,EACL,aAAa,EACb,yBAAyB,EACzB,8BAA8B,EAC9B,cAAc,EACd,cAAc,EACd,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,GACjB,2BAAuB;AACxB,YAAY,EAAE,qBAAqB,EAAE,wBAAoB;AACzD,OAAO,EAAE,qBAAqB,EAAE,wBAAoB"}

package/dist/index.mjs

@@ -1,3 +1,5 @@
 export { RampsController, getDefaultRampsControllerState } from "./RampsController.mjs";
-export { OnRampService, OnRampEnvironment } from "./OnRampService.mjs";
+export { RampsService, RampsEnvironment, RampsApiService, RAMPS_SDK_VERSION } from "./RampsService.mjs";
+export { RequestStatus, DEFAULT_REQUEST_CACHE_TTL, DEFAULT_REQUEST_CACHE_MAX_SIZE, createCacheKey, isCacheExpired, createLoadingState, createSuccessState, createErrorState } from "./RequestCache.mjs";
+export { createRequestSelector } from "./selectors.mjs";
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAQA,OAAO,EACL,eAAe,EACf,8BAA8B,EAC/B,8BAA0B;AAM3B,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,4BAAwB","sourcesContent":["export type {\n  RampsControllerActions,\n  RampsControllerEvents,\n  RampsControllerGetStateAction,\n  RampsControllerMessenger,\n  RampsControllerState,\n  RampsControllerStateChangeEvent,\n} from './RampsController';\nexport {\n  RampsController,\n  getDefaultRampsControllerState,\n} from './RampsController';\nexport type {\n  OnRampServiceActions,\n  OnRampServiceEvents,\n  OnRampServiceMessenger,\n} from './OnRampService';\nexport { OnRampService, OnRampEnvironment } from './OnRampService';\nexport type { OnRampServiceGetGeolocationAction } from './OnRampService-method-action-types';\n"]}
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AASA,OAAO,EACL,eAAe,EACf,8BAA8B,EAC/B,8BAA0B;AAU3B,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EAClB,2BAAuB;AAYxB,OAAO,EACL,aAAa,EACb,yBAAyB,EACzB,8BAA8B,EAC9B,cAAc,EACd,cAAc,EACd,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EACjB,2BAAuB;AAExB,OAAO,EAAE,qBAAqB,EAAE,wBAAoB","sourcesContent":["export type {\n  RampsControllerActions,\n  RampsControllerEvents,\n  RampsControllerGetStateAction,\n  RampsControllerMessenger,\n  RampsControllerState,\n  RampsControllerStateChangeEvent,\n  RampsControllerOptions,\n} from './RampsController';\nexport {\n  RampsController,\n  getDefaultRampsControllerState,\n} from './RampsController';\nexport type {\n  RampsServiceActions,\n  RampsServiceEvents,\n  RampsServiceMessenger,\n  Country,\n  State,\n  Eligibility,\n  CountryPhone,\n} from './RampsService';\nexport {\n  RampsService,\n  RampsEnvironment,\n  RampsApiService,\n  RAMPS_SDK_VERSION,\n} from './RampsService';\nexport type {\n  RampsServiceGetGeolocationAction,\n  RampsServiceGetCountriesAction,\n  RampsServiceGetEligibilityAction,\n} from './RampsService-method-action-types';\nexport type {\n  RequestCache,\n  RequestState,\n  ExecuteRequestOptions,\n  PendingRequest,\n} from './RequestCache';\nexport {\n  RequestStatus,\n  DEFAULT_REQUEST_CACHE_TTL,\n  DEFAULT_REQUEST_CACHE_MAX_SIZE,\n  createCacheKey,\n  isCacheExpired,\n  createLoadingState,\n  createSuccessState,\n  createErrorState,\n} from './RequestCache';\nexport type { RequestSelectorResult } from './selectors';\nexport { createRequestSelector } from './selectors';\n"]}

package/dist/selectors.cjs

@@ -0,0 +1,81 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createRequestSelector = void 0;
+const RequestCache_1 = require("./RequestCache.cjs");
+/**
+ * Creates a memoized selector for a controller method's request state.
+ *
+ * This selector tracks the loading, error, and data state for a specific
+ * controller method call. It's optimized for use with React Redux's `useSelector`
+ * hook - the selector returns the same object reference when the underlying
+ * request state hasn't changed, so no `shallowEqual` is needed.
+ *
+ * The selector uses reference equality on the request object itself, so it
+ * works correctly with arrays and objects without expensive deep equality checks.
+ *
+ * @param getState - Function that extracts RampsControllerState from the root state.
+ *   Typically a reselect selector like `selectRampsControllerState`.
+ * @param method - The controller method name (e.g., 'updateGeolocation').
+ * @param params - The parameters passed to the method, used to generate the cache key.
+ *   Must match the params used when calling the controller method.
+ * @returns A selector function that returns `{ data, isFetching, error }`.
+ *
+ * @example
+ * ```ts
+ * // In selectors file - create once at module level
+ * import { createRequestSelector } from '@metamask/ramps-controller';
+ * import { createSelector } from 'reselect';
+ *
+ * const selectRampsControllerState = createSelector(
+ *   (state: RootState) => state.engine.backgroundState.RampsController,
+ *   (rampsControllerState) => rampsControllerState,
+ * );
+ *
+ * export const selectGeolocationRequest = createRequestSelector<
+ *   RootState,
+ *   string
+ * >(selectRampsControllerState, 'updateGeolocation', []);
+ *
+ * // In hook - use directly with useSelector, no shallowEqual needed
+ * export function useRampsGeolocation() {
+ *   const { isFetching, error } = useSelector(selectGeolocationRequest);
+ *   // ... rest of hook
+ * }
+ * ```
+ *
+ * @example
+ * ```ts
+ * // For methods with parameters
+ * export const selectCryptoCurrenciesRequest = (region: string) =>
+ *   createRequestSelector<RootState, CryptoCurrency[]>(
+ *     selectRampsControllerState,
+ *     'getCryptoCurrencies',
+ *     [region],
+ *   );
+ *
+ * // In component
+ * const { data, isFetching, error } = useSelector(
+ *   selectCryptoCurrenciesRequest('US')
+ * );
+ * ```
+ */
+function createRequestSelector(getState, method, params) {
+    const cacheKey = (0, RequestCache_1.createCacheKey)(method, params);
+    let lastRequest;
+    let lastResult = null;
+    return (state) => {
+        const request = getState(state)?.requests?.[cacheKey];
+        if (request === lastRequest && lastResult !== null) {
+            return lastResult;
+        }
+        lastRequest = request;
+        lastResult = {
+            data: request?.data ?? null,
+            isFetching: request?.status === RequestCache_1.RequestStatus.LOADING,
+            error: request?.error ?? null,
+        };
+        return lastResult;
+    };
+}
+exports.createRequestSelector = createRequestSelector;
+//# sourceMappingURL=selectors.cjs.map

package/dist/selectors.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"selectors.cjs","sourceRoot":"","sources":["../src/selectors.ts"],"names":[],"mappings":";;;AAEA,qDAA+D;AAkB/D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwDG;AACH,SAAgB,qBAAqB,CACnC,QAAqE,EACrE,MAAc,EACd,MAAiB;IAEjB,MAAM,QAAQ,GAAG,IAAA,6BAAc,EAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEhD,IAAI,WAAqC,CAAC;IAC1C,IAAI,UAAU,GAAwC,IAAI,CAAC;IAE3D,OAAO,CAAC,KAAiB,EAAgC,EAAE;QACzD,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC;QAEtD,IAAI,OAAO,KAAK,WAAW,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;YACnD,OAAO,UAAU,CAAC;QACpB,CAAC;QAED,WAAW,GAAG,OAAO,CAAC;QACtB,UAAU,GAAG;YACX,IAAI,EAAG,OAAO,EAAE,IAAc,IAAI,IAAI;YACtC,UAAU,EAAE,OAAO,EAAE,MAAM,KAAK,4BAAa,CAAC,OAAO;YACrD,KAAK,EAAE,OAAO,EAAE,KAAK,IAAI,IAAI;SAC9B,CAAC;QAEF,OAAO,UAAU,CAAC;IACpB,CAAC,CAAC;AACJ,CAAC;AA1BD,sDA0BC","sourcesContent":["import type { RampsControllerState } from './RampsController';\nimport type { RequestState } from './RequestCache';\nimport { RequestStatus, createCacheKey } from './RequestCache';\n\n/**\n * Result shape returned by request selectors.\n *\n * This object is memoized - the same reference is returned when the underlying\n * request state hasn't changed, making it safe to use with React Redux's\n * `useSelector` without `shallowEqual`.\n */\nexport type RequestSelectorResult<TData> = {\n  /** The data returned by the request, or null if not yet loaded or on error. */\n  data: TData | null;\n  /** Whether the request is currently in progress. */\n  isFetching: boolean;\n  /** Error message if the request failed, or null if successful or not yet attempted. */\n  error: string | null;\n};\n\n/**\n * Creates a memoized selector for a controller method's request state.\n *\n * This selector tracks the loading, error, and data state for a specific\n * controller method call. It's optimized for use with React Redux's `useSelector`\n * hook - the selector returns the same object reference when the underlying\n * request state hasn't changed, so no `shallowEqual` is needed.\n *\n * The selector uses reference equality on the request object itself, so it\n * works correctly with arrays and objects without expensive deep equality checks.\n *\n * @param getState - Function that extracts RampsControllerState from the root state.\n *   Typically a reselect selector like `selectRampsControllerState`.\n * @param method - The controller method name (e.g., 'updateGeolocation').\n * @param params - The parameters passed to the method, used to generate the cache key.\n *   Must match the params used when calling the controller method.\n * @returns A selector function that returns `{ data, isFetching, error }`.\n *\n * @example\n * ```ts\n * // In selectors file - create once at module level\n * import { createRequestSelector } from '@metamask/ramps-controller';\n * import { createSelector } from 'reselect';\n *\n * const selectRampsControllerState = createSelector(\n *   (state: RootState) => state.engine.backgroundState.RampsController,\n *   (rampsControllerState) => rampsControllerState,\n * );\n *\n * export const selectGeolocationRequest = createRequestSelector<\n *   RootState,\n *   string\n * >(selectRampsControllerState, 'updateGeolocation', []);\n *\n * // In hook - use directly with useSelector, no shallowEqual needed\n * export function useRampsGeolocation() {\n *   const { isFetching, error } = useSelector(selectGeolocationRequest);\n *   // ... rest of hook\n * }\n * ```\n *\n * @example\n * ```ts\n * // For methods with parameters\n * export const selectCryptoCurrenciesRequest = (region: string) =>\n *   createRequestSelector<RootState, CryptoCurrency[]>(\n *     selectRampsControllerState,\n *     'getCryptoCurrencies',\n *     [region],\n *   );\n *\n * // In component\n * const { data, isFetching, error } = useSelector(\n *   selectCryptoCurrenciesRequest('US')\n * );\n * ```\n */\nexport function createRequestSelector<TRootState, TData>(\n  getState: (rootState: TRootState) => RampsControllerState | undefined,\n  method: string,\n  params: unknown[],\n): (state: TRootState) => RequestSelectorResult<TData> {\n  const cacheKey = createCacheKey(method, params);\n\n  let lastRequest: RequestState | undefined;\n  let lastResult: RequestSelectorResult<TData> | null = null;\n\n  return (state: TRootState): RequestSelectorResult<TData> => {\n    const request = getState(state)?.requests?.[cacheKey];\n\n    if (request === lastRequest && lastResult !== null) {\n      return lastResult;\n    }\n\n    lastRequest = request;\n    lastResult = {\n      data: (request?.data as TData) ?? null,\n      isFetching: request?.status === RequestStatus.LOADING,\n      error: request?.error ?? null,\n    };\n\n    return lastResult;\n  };\n}\n"]}