@metamask-previews/authenticated-user-storage 0.0.0-preview-8e9c439

package/dist/authenticated-user-storage.d.cts

@@ -0,0 +1,123 @@
+import type { DataServiceCacheUpdatedEvent, DataServiceGranularCacheUpdatedEvent, DataServiceInvalidateQueriesAction } from "@metamask/base-data-service";
+import { BaseDataService } from "@metamask/base-data-service";
+import type { CreateServicePolicyOptions } from "@metamask/controller-utils";
+import type { Messenger } from "@metamask/messenger";
+import type { AuthenticatedUserStorageServiceMethodActions } from "./authenticated-user-storage-method-action-types.cjs";
+import type { Environment } from "./env.cjs";
+import type { ClientType, DelegationResponse, DelegationSubmission, NotificationPreferences } from "./types.cjs";
+/**
+ * The name of the {@link AuthenticatedUserStorageService} service, used to
+ * namespace the service's actions and events.
+ */
+export declare const serviceName = "AuthenticatedUserStorageService";
+/**
+ * Builds the versioned API base URL for a given environment.
+ *
+ * @param environment - The target environment.
+ * @returns The base URL including the `/api/v1` path segment.
+ */
+export declare function getAuthenticatedStorageUrl(environment: Environment): string;
+/**
+ * Invalidates cached queries for {@link AuthenticatedUserStorageService}.
+ */
+export type AuthenticatedUserStorageInvalidateQueriesAction = DataServiceInvalidateQueriesAction<typeof serviceName>;
+/**
+ * Actions that {@link AuthenticatedUserStorageService} exposes to other
+ * consumers.
+ */
+export type AuthenticatedUserStorageActions = AuthenticatedUserStorageServiceMethodActions | AuthenticatedUserStorageInvalidateQueriesAction;
+/**
+ * Retrieves a bearer token from the `AuthenticationController`, logging in the
+ * user if necessary.
+ */
+type AuthenticationControllerGetBearerTokenAction = {
+    type: 'AuthenticationController:getBearerToken';
+    handler: (entropySourceId?: string) => Promise<string>;
+};
+/**
+ * Actions from other messengers that {@link AuthenticatedUserStorageService}
+ * calls.
+ */
+type AllowedActions = AuthenticationControllerGetBearerTokenAction;
+/**
+ * Published when {@link AuthenticatedUserStorageService}'s cache is updated.
+ */
+export type AuthenticatedUserStorageCacheUpdatedEvent = DataServiceCacheUpdatedEvent<typeof serviceName>;
+/**
+ * Published when a key within {@link AuthenticatedUserStorageService}'s cache
+ * is updated.
+ */
+export type AuthenticatedUserStorageGranularCacheUpdatedEvent = DataServiceGranularCacheUpdatedEvent<typeof serviceName>;
+/**
+ * Events that {@link AuthenticatedUserStorageService} exposes to other
+ * consumers.
+ */
+export type AuthenticatedUserStorageEvents = AuthenticatedUserStorageCacheUpdatedEvent | AuthenticatedUserStorageGranularCacheUpdatedEvent;
+/**
+ * Events from other messengers that
+ * {@link AuthenticatedUserStorageService} subscribes to.
+ */
+type AllowedEvents = never;
+/**
+ * The messenger which is restricted to actions and events accessed by
+ * {@link AuthenticatedUserStorageService}.
+ */
+export type AuthenticatedUserStorageMessenger = Messenger<typeof serviceName, AuthenticatedUserStorageActions | AllowedActions, AuthenticatedUserStorageEvents | AllowedEvents>;
+/**
+ * Data service wrapping authenticated user-storage API endpoints.
+ *
+ * Provides methods for managing delegations and notification preferences
+ * for the authenticated user.
+ */
+export declare class AuthenticatedUserStorageService extends BaseDataService<typeof serviceName, AuthenticatedUserStorageMessenger> {
+    #private;
+    /**
+     * Constructs a new AuthenticatedUserStorageService.
+     *
+     * @param args - The constructor arguments.
+     * @param args.messenger - The messenger suited for this service.
+     * @param args.environment - The target environment (dev, uat, prod).
+     * @param args.policyOptions - Options to pass to `createServicePolicy`, which
+     * is used to wrap each request. See {@link CreateServicePolicyOptions}.
+     */
+    constructor({ messenger, environment, policyOptions, }: {
+        messenger: AuthenticatedUserStorageMessenger;
+        environment: Environment;
+        policyOptions?: CreateServicePolicyOptions;
+    });
+    /**
+     * Returns all delegation records belonging to the authenticated user.
+     *
+     * @returns An array of delegation records, or an empty array if none exist.
+     */
+    listDelegations(): Promise<DelegationResponse[]>;
+    /**
+     * Stores a signed delegation record for the authenticated user.
+     *
+     * @param submission - The signed delegation and its metadata.
+     * @param clientType - Optional client type header.
+     */
+    createDelegation(submission: DelegationSubmission, clientType?: ClientType): Promise<void>;
+    /**
+     * Revokes (deletes) a delegation record.
+     *
+     * @param delegationHash - The unique hash identifying the delegation.
+     */
+    revokeDelegation(delegationHash: string): Promise<void>;
+    /**
+     * Returns the notification preferences for the authenticated user.
+     *
+     * @returns The notification preferences object, or `null` if none have been
+     * set (404).
+     */
+    getNotificationPreferences(): Promise<NotificationPreferences | null>;
+    /**
+     * Creates or updates the notification preferences for the authenticated user.
+     *
+     * @param prefs - The full notification preferences object.
+     * @param clientType - Optional client type header.
+     */
+    putNotificationPreferences(prefs: NotificationPreferences, clientType?: ClientType): Promise<void>;
+}
+export {};
+//# sourceMappingURL=authenticated-user-storage.d.cts.map

package/dist/authenticated-user-storage.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"authenticated-user-storage.d.cts","sourceRoot":"","sources":["../src/authenticated-user-storage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,4BAA4B,EAC5B,oCAAoC,EACpC,kCAAkC,EACnC,oCAAoC;AACrC,OAAO,EAAE,eAAe,EAAE,oCAAoC;AAC9D,OAAO,KAAK,EAAE,0BAA0B,EAAE,mCAAmC;AAE7E,OAAO,KAAK,EAAE,SAAS,EAAE,4BAA4B;AAGrD,OAAO,KAAK,EAAE,4CAA4C,EAAE,6DAAyD;AACrH,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAc;AAEzC,OAAO,KAAK,EACV,UAAU,EACV,kBAAkB,EAClB,oBAAoB,EACpB,uBAAuB,EACxB,oBAAgB;AAQjB;;;GAGG;AACH,eAAO,MAAM,WAAW,oCAAoC,CAAC;AAE7D;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,WAAW,EAAE,WAAW,GAAG,MAAM,CAE3E;AAYD;;GAEG;AACH,MAAM,MAAM,+CAA+C,GACzD,kCAAkC,CAAC,OAAO,WAAW,CAAC,CAAC;AAEzD;;;GAGG;AACH,MAAM,MAAM,+BAA+B,GACvC,4CAA4C,GAC5C,+CAA+C,CAAC;AAEpD;;;GAGG;AACH,KAAK,4CAA4C,GAAG;IAClD,IAAI,EAAE,yCAAyC,CAAC;IAChD,OAAO,EAAE,CAAC,eAAe,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CACxD,CAAC;AAEF;;;GAGG;AACH,KAAK,cAAc,GAAG,4CAA4C,CAAC;AAEnE;;GAEG;AACH,MAAM,MAAM,yCAAyC,GACnD,4BAA4B,CAAC,OAAO,WAAW,CAAC,CAAC;AAEnD;;;GAGG;AACH,MAAM,MAAM,iDAAiD,GAC3D,oCAAoC,CAAC,OAAO,WAAW,CAAC,CAAC;AAE3D;;;GAGG;AACH,MAAM,MAAM,8BAA8B,GACtC,yCAAyC,GACzC,iDAAiD,CAAC;AAEtD;;;GAGG;AACH,KAAK,aAAa,GAAG,KAAK,CAAC;AAE3B;;;GAGG;AACH,MAAM,MAAM,iCAAiC,GAAG,SAAS,CACvD,OAAO,WAAW,EAClB,+BAA+B,GAAG,cAAc,EAChD,8BAA8B,GAAG,aAAa,CAC/C,CAAC;AAIF;;;;;GAKG;AACH,qBAAa,+BAAgC,SAAQ,eAAe,CAClE,OAAO,WAAW,EAClB,iCAAiC,CAClC;;IAGC;;;;;;;;OAQG;gBACS,EACV,SAAS,EACT,WAAW,EACX,aAAa,GACd,EAAE;QACD,SAAS,EAAE,iCAAiC,CAAC;QAC7C,WAAW,EAAE,WAAW,CAAC;QACzB,aAAa,CAAC,EAAE,0BAA0B,CAAC;KAC5C;IAUD;;;;OAIG;IACG,eAAe,IAAI,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAwBtD;;;;;OAKG;IACG,gBAAgB,CACpB,UAAU,EAAE,oBAAoB,EAChC,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,IAAI,CAAC;IAiChB;;;;OAIG;IACG,gBAAgB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA6B7D;;;;;OAKG;IACG,0BAA0B,IAAI,OAAO,CAAC,uBAAuB,GAAG,IAAI,CAAC;IAgC3E;;;;;OAKG;IACG,0BAA0B,CAC9B,KAAK,EAAE,uBAAuB,EAC9B,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,IAAI,CAAC;CA8CjB"}

package/dist/authenticated-user-storage.d.mts

@@ -0,0 +1,123 @@
+import type { DataServiceCacheUpdatedEvent, DataServiceGranularCacheUpdatedEvent, DataServiceInvalidateQueriesAction } from "@metamask/base-data-service";
+import { BaseDataService } from "@metamask/base-data-service";
+import type { CreateServicePolicyOptions } from "@metamask/controller-utils";
+import type { Messenger } from "@metamask/messenger";
+import type { AuthenticatedUserStorageServiceMethodActions } from "./authenticated-user-storage-method-action-types.mjs";
+import type { Environment } from "./env.mjs";
+import type { ClientType, DelegationResponse, DelegationSubmission, NotificationPreferences } from "./types.mjs";
+/**
+ * The name of the {@link AuthenticatedUserStorageService} service, used to
+ * namespace the service's actions and events.
+ */
+export declare const serviceName = "AuthenticatedUserStorageService";
+/**
+ * Builds the versioned API base URL for a given environment.
+ *
+ * @param environment - The target environment.
+ * @returns The base URL including the `/api/v1` path segment.
+ */
+export declare function getAuthenticatedStorageUrl(environment: Environment): string;
+/**
+ * Invalidates cached queries for {@link AuthenticatedUserStorageService}.
+ */
+export type AuthenticatedUserStorageInvalidateQueriesAction = DataServiceInvalidateQueriesAction<typeof serviceName>;
+/**
+ * Actions that {@link AuthenticatedUserStorageService} exposes to other
+ * consumers.
+ */
+export type AuthenticatedUserStorageActions = AuthenticatedUserStorageServiceMethodActions | AuthenticatedUserStorageInvalidateQueriesAction;
+/**
+ * Retrieves a bearer token from the `AuthenticationController`, logging in the
+ * user if necessary.
+ */
+type AuthenticationControllerGetBearerTokenAction = {
+    type: 'AuthenticationController:getBearerToken';
+    handler: (entropySourceId?: string) => Promise<string>;
+};
+/**
+ * Actions from other messengers that {@link AuthenticatedUserStorageService}
+ * calls.
+ */
+type AllowedActions = AuthenticationControllerGetBearerTokenAction;
+/**
+ * Published when {@link AuthenticatedUserStorageService}'s cache is updated.
+ */
+export type AuthenticatedUserStorageCacheUpdatedEvent = DataServiceCacheUpdatedEvent<typeof serviceName>;
+/**
+ * Published when a key within {@link AuthenticatedUserStorageService}'s cache
+ * is updated.
+ */
+export type AuthenticatedUserStorageGranularCacheUpdatedEvent = DataServiceGranularCacheUpdatedEvent<typeof serviceName>;
+/**
+ * Events that {@link AuthenticatedUserStorageService} exposes to other
+ * consumers.
+ */
+export type AuthenticatedUserStorageEvents = AuthenticatedUserStorageCacheUpdatedEvent | AuthenticatedUserStorageGranularCacheUpdatedEvent;
+/**
+ * Events from other messengers that
+ * {@link AuthenticatedUserStorageService} subscribes to.
+ */
+type AllowedEvents = never;
+/**
+ * The messenger which is restricted to actions and events accessed by
+ * {@link AuthenticatedUserStorageService}.
+ */
+export type AuthenticatedUserStorageMessenger = Messenger<typeof serviceName, AuthenticatedUserStorageActions | AllowedActions, AuthenticatedUserStorageEvents | AllowedEvents>;
+/**
+ * Data service wrapping authenticated user-storage API endpoints.
+ *
+ * Provides methods for managing delegations and notification preferences
+ * for the authenticated user.
+ */
+export declare class AuthenticatedUserStorageService extends BaseDataService<typeof serviceName, AuthenticatedUserStorageMessenger> {
+    #private;
+    /**
+     * Constructs a new AuthenticatedUserStorageService.
+     *
+     * @param args - The constructor arguments.
+     * @param args.messenger - The messenger suited for this service.
+     * @param args.environment - The target environment (dev, uat, prod).
+     * @param args.policyOptions - Options to pass to `createServicePolicy`, which
+     * is used to wrap each request. See {@link CreateServicePolicyOptions}.
+     */
+    constructor({ messenger, environment, policyOptions, }: {
+        messenger: AuthenticatedUserStorageMessenger;
+        environment: Environment;
+        policyOptions?: CreateServicePolicyOptions;
+    });
+    /**
+     * Returns all delegation records belonging to the authenticated user.
+     *
+     * @returns An array of delegation records, or an empty array if none exist.
+     */
+    listDelegations(): Promise<DelegationResponse[]>;
+    /**
+     * Stores a signed delegation record for the authenticated user.
+     *
+     * @param submission - The signed delegation and its metadata.
+     * @param clientType - Optional client type header.
+     */
+    createDelegation(submission: DelegationSubmission, clientType?: ClientType): Promise<void>;
+    /**
+     * Revokes (deletes) a delegation record.
+     *
+     * @param delegationHash - The unique hash identifying the delegation.
+     */
+    revokeDelegation(delegationHash: string): Promise<void>;
+    /**
+     * Returns the notification preferences for the authenticated user.
+     *
+     * @returns The notification preferences object, or `null` if none have been
+     * set (404).
+     */
+    getNotificationPreferences(): Promise<NotificationPreferences | null>;
+    /**
+     * Creates or updates the notification preferences for the authenticated user.
+     *
+     * @param prefs - The full notification preferences object.
+     * @param clientType - Optional client type header.
+     */
+    putNotificationPreferences(prefs: NotificationPreferences, clientType?: ClientType): Promise<void>;
+}
+export {};
+//# sourceMappingURL=authenticated-user-storage.d.mts.map

package/dist/authenticated-user-storage.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"authenticated-user-storage.d.mts","sourceRoot":"","sources":["../src/authenticated-user-storage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,4BAA4B,EAC5B,oCAAoC,EACpC,kCAAkC,EACnC,oCAAoC;AACrC,OAAO,EAAE,eAAe,EAAE,oCAAoC;AAC9D,OAAO,KAAK,EAAE,0BAA0B,EAAE,mCAAmC;AAE7E,OAAO,KAAK,EAAE,SAAS,EAAE,4BAA4B;AAGrD,OAAO,KAAK,EAAE,4CAA4C,EAAE,6DAAyD;AACrH,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAc;AAEzC,OAAO,KAAK,EACV,UAAU,EACV,kBAAkB,EAClB,oBAAoB,EACpB,uBAAuB,EACxB,oBAAgB;AAQjB;;;GAGG;AACH,eAAO,MAAM,WAAW,oCAAoC,CAAC;AAE7D;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,WAAW,EAAE,WAAW,GAAG,MAAM,CAE3E;AAYD;;GAEG;AACH,MAAM,MAAM,+CAA+C,GACzD,kCAAkC,CAAC,OAAO,WAAW,CAAC,CAAC;AAEzD;;;GAGG;AACH,MAAM,MAAM,+BAA+B,GACvC,4CAA4C,GAC5C,+CAA+C,CAAC;AAEpD;;;GAGG;AACH,KAAK,4CAA4C,GAAG;IAClD,IAAI,EAAE,yCAAyC,CAAC;IAChD,OAAO,EAAE,CAAC,eAAe,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CACxD,CAAC;AAEF;;;GAGG;AACH,KAAK,cAAc,GAAG,4CAA4C,CAAC;AAEnE;;GAEG;AACH,MAAM,MAAM,yCAAyC,GACnD,4BAA4B,CAAC,OAAO,WAAW,CAAC,CAAC;AAEnD;;;GAGG;AACH,MAAM,MAAM,iDAAiD,GAC3D,oCAAoC,CAAC,OAAO,WAAW,CAAC,CAAC;AAE3D;;;GAGG;AACH,MAAM,MAAM,8BAA8B,GACtC,yCAAyC,GACzC,iDAAiD,CAAC;AAEtD;;;GAGG;AACH,KAAK,aAAa,GAAG,KAAK,CAAC;AAE3B;;;GAGG;AACH,MAAM,MAAM,iCAAiC,GAAG,SAAS,CACvD,OAAO,WAAW,EAClB,+BAA+B,GAAG,cAAc,EAChD,8BAA8B,GAAG,aAAa,CAC/C,CAAC;AAIF;;;;;GAKG;AACH,qBAAa,+BAAgC,SAAQ,eAAe,CAClE,OAAO,WAAW,EAClB,iCAAiC,CAClC;;IAGC;;;;;;;;OAQG;gBACS,EACV,SAAS,EACT,WAAW,EACX,aAAa,GACd,EAAE;QACD,SAAS,EAAE,iCAAiC,CAAC;QAC7C,WAAW,EAAE,WAAW,CAAC;QACzB,aAAa,CAAC,EAAE,0BAA0B,CAAC;KAC5C;IAUD;;;;OAIG;IACG,eAAe,IAAI,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAwBtD;;;;;OAKG;IACG,gBAAgB,CACpB,UAAU,EAAE,oBAAoB,EAChC,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,IAAI,CAAC;IAiChB;;;;OAIG;IACG,gBAAgB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA6B7D;;;;;OAKG;IACG,0BAA0B,IAAI,OAAO,CAAC,uBAAuB,GAAG,IAAI,CAAC;IAgC3E;;;;;OAKG;IACG,0BAA0B,CAC9B,KAAK,EAAE,uBAAuB,EAC9B,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,IAAI,CAAC;CA8CjB"}

package/dist/authenticated-user-storage.mjs

@@ -0,0 +1,213 @@
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _AuthenticatedUserStorageService_instances, _AuthenticatedUserStorageService_environment, _AuthenticatedUserStorageService_getHeaders;
+import { BaseDataService } from "@metamask/base-data-service";
+import { HttpError } from "@metamask/controller-utils";
+import { getUserStorageApiUrl } from "./env.mjs";
+import { assertDelegationResponseArray, assertNotificationPreferences } from "./validators.mjs";
+// === GENERAL ===
+/**
+ * The name of the {@link AuthenticatedUserStorageService} service, used to
+ * namespace the service's actions and events.
+ */
+export const serviceName = 'AuthenticatedUserStorageService';
+/**
+ * Builds the versioned API base URL for a given environment.
+ *
+ * @param environment - The target environment.
+ * @returns The base URL including the `/api/v1` path segment.
+ */
+export function getAuthenticatedStorageUrl(environment) {
+    return `${getUserStorageApiUrl(environment)}/api/v1`;
+}
+// === MESSENGER ===
+const MESSENGER_EXPOSED_METHODS = [
+    'listDelegations',
+    'createDelegation',
+    'revokeDelegation',
+    'getNotificationPreferences',
+    'putNotificationPreferences',
+];
+// === SERVICE ===
+/**
+ * Data service wrapping authenticated user-storage API endpoints.
+ *
+ * Provides methods for managing delegations and notification preferences
+ * for the authenticated user.
+ */
+export class AuthenticatedUserStorageService extends BaseDataService {
+    /**
+     * Constructs a new AuthenticatedUserStorageService.
+     *
+     * @param args - The constructor arguments.
+     * @param args.messenger - The messenger suited for this service.
+     * @param args.environment - The target environment (dev, uat, prod).
+     * @param args.policyOptions - Options to pass to `createServicePolicy`, which
+     * is used to wrap each request. See {@link CreateServicePolicyOptions}.
+     */
+    constructor({ messenger, environment, policyOptions, }) {
+        super({ name: serviceName, messenger, policyOptions });
+        _AuthenticatedUserStorageService_instances.add(this);
+        _AuthenticatedUserStorageService_environment.set(this, void 0);
+        __classPrivateFieldSet(this, _AuthenticatedUserStorageService_environment, environment, "f");
+        this.messenger.registerMethodActionHandlers(this, MESSENGER_EXPOSED_METHODS);
+    }
+    /**
+     * Returns all delegation records belonging to the authenticated user.
+     *
+     * @returns An array of delegation records, or an empty array if none exist.
+     */
+    async listDelegations() {
+        const url = `${getAuthenticatedStorageUrl(__classPrivateFieldGet(this, _AuthenticatedUserStorageService_environment, "f"))}/delegations`;
+        const data = await this.fetchQuery({
+            queryKey: [`${this.name}:listDelegations`],
+            queryFn: async () => {
+                const headers = await __classPrivateFieldGet(this, _AuthenticatedUserStorageService_instances, "m", _AuthenticatedUserStorageService_getHeaders).call(this);
+                const response = await fetch(url, { headers });
+                if (!response.ok) {
+                    throw new HttpError(response.status, `Failed to list delegations: ${response.status}`);
+                }
+                return response.json();
+            },
+        });
+        assertDelegationResponseArray(data);
+        return data;
+    }
+    /**
+     * Stores a signed delegation record for the authenticated user.
+     *
+     * @param submission - The signed delegation and its metadata.
+     * @param clientType - Optional client type header.
+     */
+    async createDelegation(submission, clientType) {
+        const url = `${getAuthenticatedStorageUrl(__classPrivateFieldGet(this, _AuthenticatedUserStorageService_environment, "f"))}/delegations`;
+        await this.fetchQuery({
+            queryKey: [
+                `${this.name}:createDelegation`,
+                submission.metadata.delegationHash,
+            ],
+            staleTime: 0,
+            queryFn: async () => {
+                const headers = await __classPrivateFieldGet(this, _AuthenticatedUserStorageService_instances, "m", _AuthenticatedUserStorageService_getHeaders).call(this, clientType);
+                const response = await fetch(url, {
+                    method: 'POST',
+                    headers,
+                    body: JSON.stringify(submission),
+                });
+                if (!response.ok) {
+                    throw new HttpError(response.status, `Failed to create delegation: ${response.status}`);
+                }
+                return null;
+            },
+        });
+        await this.invalidateQueries({
+            queryKey: [`${this.name}:listDelegations`],
+        });
+    }
+    /**
+     * Revokes (deletes) a delegation record.
+     *
+     * @param delegationHash - The unique hash identifying the delegation.
+     */
+    async revokeDelegation(delegationHash) {
+        const url = `${getAuthenticatedStorageUrl(__classPrivateFieldGet(this, _AuthenticatedUserStorageService_environment, "f"))}/delegations/${encodeURIComponent(delegationHash)}`;
+        await this.fetchQuery({
+            queryKey: [`${this.name}:revokeDelegation`, delegationHash],
+            staleTime: 0,
+            queryFn: async () => {
+                const headers = await __classPrivateFieldGet(this, _AuthenticatedUserStorageService_instances, "m", _AuthenticatedUserStorageService_getHeaders).call(this);
+                const response = await fetch(url, {
+                    method: 'DELETE',
+                    headers,
+                });
+                if (!response.ok) {
+                    throw new HttpError(response.status, `Failed to revoke delegation: ${response.status}`);
+                }
+                return null;
+            },
+        });
+        await this.invalidateQueries({
+            queryKey: [`${this.name}:listDelegations`],
+        });
+    }
+    /**
+     * Returns the notification preferences for the authenticated user.
+     *
+     * @returns The notification preferences object, or `null` if none have been
+     * set (404).
+     */
+    async getNotificationPreferences() {
+        const url = `${getAuthenticatedStorageUrl(__classPrivateFieldGet(this, _AuthenticatedUserStorageService_environment, "f"))}/preferences/notifications`;
+        const data = await this.fetchQuery({
+            queryKey: [`${this.name}:getNotificationPreferences`],
+            queryFn: async () => {
+                const headers = await __classPrivateFieldGet(this, _AuthenticatedUserStorageService_instances, "m", _AuthenticatedUserStorageService_getHeaders).call(this);
+                const response = await fetch(url, { headers });
+                if (response.status === 404) {
+                    return null;
+                }
+                if (!response.ok) {
+                    throw new HttpError(response.status, `Failed to get notification preferences: ${response.status}`);
+                }
+                return response.json();
+            },
+        });
+        if (data === null) {
+            return null;
+        }
+        assertNotificationPreferences(data);
+        return data;
+    }
+    /**
+     * Creates or updates the notification preferences for the authenticated user.
+     *
+     * @param prefs - The full notification preferences object.
+     * @param clientType - Optional client type header.
+     */
+    async putNotificationPreferences(prefs, clientType) {
+        const url = `${getAuthenticatedStorageUrl(__classPrivateFieldGet(this, _AuthenticatedUserStorageService_environment, "f"))}/preferences/notifications`;
+        await this.fetchQuery({
+            queryKey: [
+                `${this.name}:putNotificationPreferences`,
+                prefs,
+            ],
+            staleTime: 0,
+            queryFn: async () => {
+                const headers = await __classPrivateFieldGet(this, _AuthenticatedUserStorageService_instances, "m", _AuthenticatedUserStorageService_getHeaders).call(this, clientType);
+                const response = await fetch(url, {
+                    method: 'PUT',
+                    headers,
+                    body: JSON.stringify(prefs),
+                });
+                if (!response.ok) {
+                    throw new HttpError(response.status, `Failed to put notification preferences: ${response.status}`);
+                }
+                return null;
+            },
+        });
+        await this.invalidateQueries({
+            queryKey: [`${this.name}:getNotificationPreferences`],
+        });
+    }
+}
+_AuthenticatedUserStorageService_environment = new WeakMap(), _AuthenticatedUserStorageService_instances = new WeakSet(), _AuthenticatedUserStorageService_getHeaders = async function _AuthenticatedUserStorageService_getHeaders(clientType) {
+    const accessToken = await this.messenger.call('AuthenticationController:getBearerToken');
+    const headers = {
+        'Content-Type': 'application/json',
+        Authorization: `Bearer ${accessToken}`,
+    };
+    if (clientType) {
+        headers['X-Client-Type'] = clientType;
+    }
+    return headers;
+};
+//# sourceMappingURL=authenticated-user-storage.mjs.map

package/dist/authenticated-user-storage.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"authenticated-user-storage.mjs","sourceRoot":"","sources":["../src/authenticated-user-storage.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  DataServiceCacheUpdatedEvent,\n  DataServiceGranularCacheUpdatedEvent,\n  DataServiceInvalidateQueriesAction,\n} from '@metamask/base-data-service';\nimport { BaseDataService } from '@metamask/base-data-service';\nimport type { CreateServicePolicyOptions } from '@metamask/controller-utils';\nimport { HttpError } from '@metamask/controller-utils';\nimport type { Messenger } from '@metamask/messenger';\nimport type { Json } from '@metamask/utils';\n\nimport type { AuthenticatedUserStorageServiceMethodActions } from './authenticated-user-storage-method-action-types';\nimport type { Environment } from './env';\nimport { getUserStorageApiUrl } from './env';\nimport type {\n  ClientType,\n  DelegationResponse,\n  DelegationSubmission,\n  NotificationPreferences,\n} from './types';\nimport {\n  assertDelegationResponseArray,\n  assertNotificationPreferences,\n} from './validators';\n\n// === GENERAL ===\n\n/**\n * The name of the {@link AuthenticatedUserStorageService} service, used to\n * namespace the service's actions and events.\n */\nexport const serviceName = 'AuthenticatedUserStorageService';\n\n/**\n * Builds the versioned API base URL for a given environment.\n *\n * @param environment - The target environment.\n * @returns The base URL including the `/api/v1` path segment.\n */\nexport function getAuthenticatedStorageUrl(environment: Environment): string {\n  return `${getUserStorageApiUrl(environment)}/api/v1`;\n}\n\n// === MESSENGER ===\n\nconst MESSENGER_EXPOSED_METHODS = [\n  'listDelegations',\n  'createDelegation',\n  'revokeDelegation',\n  'getNotificationPreferences',\n  'putNotificationPreferences',\n] as const;\n\n/**\n * Invalidates cached queries for {@link AuthenticatedUserStorageService}.\n */\nexport type AuthenticatedUserStorageInvalidateQueriesAction =\n  DataServiceInvalidateQueriesAction<typeof serviceName>;\n\n/**\n * Actions that {@link AuthenticatedUserStorageService} exposes to other\n * consumers.\n */\nexport type AuthenticatedUserStorageActions =\n  | AuthenticatedUserStorageServiceMethodActions\n  | AuthenticatedUserStorageInvalidateQueriesAction;\n\n/**\n * Retrieves a bearer token from the `AuthenticationController`, logging in the\n * user if necessary.\n */\ntype AuthenticationControllerGetBearerTokenAction = {\n  type: 'AuthenticationController:getBearerToken';\n  handler: (entropySourceId?: string) => Promise<string>;\n};\n\n/**\n * Actions from other messengers that {@link AuthenticatedUserStorageService}\n * calls.\n */\ntype AllowedActions = AuthenticationControllerGetBearerTokenAction;\n\n/**\n * Published when {@link AuthenticatedUserStorageService}'s cache is updated.\n */\nexport type AuthenticatedUserStorageCacheUpdatedEvent =\n  DataServiceCacheUpdatedEvent<typeof serviceName>;\n\n/**\n * Published when a key within {@link AuthenticatedUserStorageService}'s cache\n * is updated.\n */\nexport type AuthenticatedUserStorageGranularCacheUpdatedEvent =\n  DataServiceGranularCacheUpdatedEvent<typeof serviceName>;\n\n/**\n * Events that {@link AuthenticatedUserStorageService} exposes to other\n * consumers.\n */\nexport type AuthenticatedUserStorageEvents =\n  | AuthenticatedUserStorageCacheUpdatedEvent\n  | AuthenticatedUserStorageGranularCacheUpdatedEvent;\n\n/**\n * Events from other messengers that\n * {@link AuthenticatedUserStorageService} subscribes to.\n */\ntype AllowedEvents = never;\n\n/**\n * The messenger which is restricted to actions and events accessed by\n * {@link AuthenticatedUserStorageService}.\n */\nexport type AuthenticatedUserStorageMessenger = Messenger<\n  typeof serviceName,\n  AuthenticatedUserStorageActions | AllowedActions,\n  AuthenticatedUserStorageEvents | AllowedEvents\n>;\n\n// === SERVICE ===\n\n/**\n * Data service wrapping authenticated user-storage API endpoints.\n *\n * Provides methods for managing delegations and notification preferences\n * for the authenticated user.\n */\nexport class AuthenticatedUserStorageService extends BaseDataService<\n  typeof serviceName,\n  AuthenticatedUserStorageMessenger\n> {\n  readonly #environment: Environment;\n\n  /**\n   * Constructs a new AuthenticatedUserStorageService.\n   *\n   * @param args - The constructor arguments.\n   * @param args.messenger - The messenger suited for this service.\n   * @param args.environment - The target environment (dev, uat, prod).\n   * @param args.policyOptions - Options to pass to `createServicePolicy`, which\n   * is used to wrap each request. See {@link CreateServicePolicyOptions}.\n   */\n  constructor({\n    messenger,\n    environment,\n    policyOptions,\n  }: {\n    messenger: AuthenticatedUserStorageMessenger;\n    environment: Environment;\n    policyOptions?: CreateServicePolicyOptions;\n  }) {\n    super({ name: serviceName, messenger, policyOptions });\n    this.#environment = environment;\n\n    this.messenger.registerMethodActionHandlers(\n      this,\n      MESSENGER_EXPOSED_METHODS,\n    );\n  }\n\n  /**\n   * Returns all delegation records belonging to the authenticated user.\n   *\n   * @returns An array of delegation records, or an empty array if none exist.\n   */\n  async listDelegations(): Promise<DelegationResponse[]> {\n    const url = `${getAuthenticatedStorageUrl(this.#environment)}/delegations`;\n\n    const data = await this.fetchQuery({\n      queryKey: [`${this.name}:listDelegations`],\n      queryFn: async () => {\n        const headers = await this.#getHeaders();\n        const response = await fetch(url, { headers });\n\n        if (!response.ok) {\n          throw new HttpError(\n            response.status,\n            `Failed to list delegations: ${response.status}`,\n          );\n        }\n\n        return response.json();\n      },\n    });\n\n    assertDelegationResponseArray(data);\n    return data;\n  }\n\n  /**\n   * Stores a signed delegation record for the authenticated user.\n   *\n   * @param submission - The signed delegation and its metadata.\n   * @param clientType - Optional client type header.\n   */\n  async createDelegation(\n    submission: DelegationSubmission,\n    clientType?: ClientType,\n  ): Promise<void> {\n    const url = `${getAuthenticatedStorageUrl(this.#environment)}/delegations`;\n\n    await this.fetchQuery({\n      queryKey: [\n        `${this.name}:createDelegation`,\n        submission.metadata.delegationHash,\n      ],\n      staleTime: 0,\n      queryFn: async () => {\n        const headers = await this.#getHeaders(clientType);\n        const response = await fetch(url, {\n          method: 'POST',\n          headers,\n          body: JSON.stringify(submission),\n        });\n\n        if (!response.ok) {\n          throw new HttpError(\n            response.status,\n            `Failed to create delegation: ${response.status}`,\n          );\n        }\n\n        return null;\n      },\n    });\n\n    await this.invalidateQueries({\n      queryKey: [`${this.name}:listDelegations`],\n    });\n  }\n\n  /**\n   * Revokes (deletes) a delegation record.\n   *\n   * @param delegationHash - The unique hash identifying the delegation.\n   */\n  async revokeDelegation(delegationHash: string): Promise<void> {\n    const url = `${getAuthenticatedStorageUrl(this.#environment)}/delegations/${encodeURIComponent(delegationHash)}`;\n\n    await this.fetchQuery({\n      queryKey: [`${this.name}:revokeDelegation`, delegationHash],\n      staleTime: 0,\n      queryFn: async () => {\n        const headers = await this.#getHeaders();\n        const response = await fetch(url, {\n          method: 'DELETE',\n          headers,\n        });\n\n        if (!response.ok) {\n          throw new HttpError(\n            response.status,\n            `Failed to revoke delegation: ${response.status}`,\n          );\n        }\n\n        return null;\n      },\n    });\n\n    await this.invalidateQueries({\n      queryKey: [`${this.name}:listDelegations`],\n    });\n  }\n\n  /**\n   * Returns the notification preferences for the authenticated user.\n   *\n   * @returns The notification preferences object, or `null` if none have been\n   * set (404).\n   */\n  async getNotificationPreferences(): Promise<NotificationPreferences | null> {\n    const url = `${getAuthenticatedStorageUrl(this.#environment)}/preferences/notifications`;\n\n    const data = await this.fetchQuery({\n      queryKey: [`${this.name}:getNotificationPreferences`],\n      queryFn: async () => {\n        const headers = await this.#getHeaders();\n        const response = await fetch(url, { headers });\n\n        if (response.status === 404) {\n          return null;\n        }\n\n        if (!response.ok) {\n          throw new HttpError(\n            response.status,\n            `Failed to get notification preferences: ${response.status}`,\n          );\n        }\n\n        return response.json();\n      },\n    });\n\n    if (data === null) {\n      return null;\n    }\n\n    assertNotificationPreferences(data);\n    return data;\n  }\n\n  /**\n   * Creates or updates the notification preferences for the authenticated user.\n   *\n   * @param prefs - The full notification preferences object.\n   * @param clientType - Optional client type header.\n   */\n  async putNotificationPreferences(\n    prefs: NotificationPreferences,\n    clientType?: ClientType,\n  ): Promise<void> {\n    const url = `${getAuthenticatedStorageUrl(this.#environment)}/preferences/notifications`;\n\n    await this.fetchQuery({\n      queryKey: [\n        `${this.name}:putNotificationPreferences`,\n        prefs as unknown as Json,\n      ],\n      staleTime: 0,\n      queryFn: async () => {\n        const headers = await this.#getHeaders(clientType);\n        const response = await fetch(url, {\n          method: 'PUT',\n          headers,\n          body: JSON.stringify(prefs),\n        });\n\n        if (!response.ok) {\n          throw new HttpError(\n            response.status,\n            `Failed to put notification preferences: ${response.status}`,\n          );\n        }\n\n        return null;\n      },\n    });\n\n    await this.invalidateQueries({\n      queryKey: [`${this.name}:getNotificationPreferences`],\n    });\n  }\n\n  async #getHeaders(clientType?: ClientType): Promise<Record<string, string>> {\n    const accessToken = await this.messenger.call(\n      'AuthenticationController:getBearerToken',\n    );\n    const headers: Record<string, string> = {\n      'Content-Type': 'application/json',\n      Authorization: `Bearer ${accessToken}`,\n    };\n    if (clientType) {\n      headers['X-Client-Type'] = clientType;\n    }\n    return headers;\n  }\n}\n"]}

package/dist/env.cjs

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getUserStorageApiUrl = void 0;
+const API_SUBDOMAINS = {
+    dev: 'dev-api',
+    uat: 'uat-api',
+    prod: 'api',
+};
+/**
+ * Returns the user-storage API base URL for the given environment.
+ *
+ * @param environment - The target environment.
+ * @returns The base URL for the user-storage API.
+ * @throws If the environment is invalid.
+ */
+function getUserStorageApiUrl(environment) {
+    const subdomain = API_SUBDOMAINS[environment];
+    if (!subdomain) {
+        throw new Error(`Invalid environment: ${String(environment)}`);
+    }
+    return `https://user-storage.${subdomain}.cx.metamask.io`;
+}
+exports.getUserStorageApiUrl = getUserStorageApiUrl;
+//# sourceMappingURL=env.cjs.map

package/dist/env.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.cjs","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":";;;AAEA,MAAM,cAAc,GAAG;IACrB,GAAG,EAAE,SAAS;IACd,GAAG,EAAE,SAAS;IACd,IAAI,EAAE,KAAK;CACmC,CAAC;AAEjD;;;;;;GAMG;AACH,SAAgB,oBAAoB,CAAC,WAAwB;IAC3D,MAAM,SAAS,GAAG,cAAc,CAAC,WAAW,CAAC,CAAC;IAC9C,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,wBAAwB,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;IACjE,CAAC;IACD,OAAO,wBAAwB,SAAS,iBAAiB,CAAC;AAC5D,CAAC;AAND,oDAMC","sourcesContent":["export type Environment = 'dev' | 'uat' | 'prod';\n\nconst API_SUBDOMAINS = {\n  dev: 'dev-api',\n  uat: 'uat-api',\n  prod: 'api',\n} as const satisfies Record<Environment, string>;\n\n/**\n * Returns the user-storage API base URL for the given environment.\n *\n * @param environment - The target environment.\n * @returns The base URL for the user-storage API.\n * @throws If the environment is invalid.\n */\nexport function getUserStorageApiUrl(environment: Environment): string {\n  const subdomain = API_SUBDOMAINS[environment];\n  if (!subdomain) {\n    throw new Error(`Invalid environment: ${String(environment)}`);\n  }\n  return `https://user-storage.${subdomain}.cx.metamask.io`;\n}\n"]}

package/dist/env.d.cts

@@ -0,0 +1,10 @@
+export type Environment = 'dev' | 'uat' | 'prod';
+/**
+ * Returns the user-storage API base URL for the given environment.
+ *
+ * @param environment - The target environment.
+ * @returns The base URL for the user-storage API.
+ * @throws If the environment is invalid.
+ */
+export declare function getUserStorageApiUrl(environment: Environment): string;
+//# sourceMappingURL=env.d.cts.map

package/dist/env.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.cts","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC;AAQjD;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,WAAW,GAAG,MAAM,CAMrE"}

package/dist/env.d.mts

@@ -0,0 +1,10 @@
+export type Environment = 'dev' | 'uat' | 'prod';
+/**
+ * Returns the user-storage API base URL for the given environment.
+ *
+ * @param environment - The target environment.
+ * @returns The base URL for the user-storage API.
+ * @throws If the environment is invalid.
+ */
+export declare function getUserStorageApiUrl(environment: Environment): string;
+//# sourceMappingURL=env.d.mts.map

package/dist/env.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.mts","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC;AAQjD;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,WAAW,GAAG,MAAM,CAMrE"}

package/dist/env.mjs

@@ -0,0 +1,20 @@
+const API_SUBDOMAINS = {
+    dev: 'dev-api',
+    uat: 'uat-api',
+    prod: 'api',
+};
+/**
+ * Returns the user-storage API base URL for the given environment.
+ *
+ * @param environment - The target environment.
+ * @returns The base URL for the user-storage API.
+ * @throws If the environment is invalid.
+ */
+export function getUserStorageApiUrl(environment) {
+    const subdomain = API_SUBDOMAINS[environment];
+    if (!subdomain) {
+        throw new Error(`Invalid environment: ${String(environment)}`);
+    }
+    return `https://user-storage.${subdomain}.cx.metamask.io`;
+}
+//# sourceMappingURL=env.mjs.map

package/dist/env.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.mjs","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAEA,MAAM,cAAc,GAAG;IACrB,GAAG,EAAE,SAAS;IACd,GAAG,EAAE,SAAS;IACd,IAAI,EAAE,KAAK;CACmC,CAAC;AAEjD;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAAC,WAAwB;IAC3D,MAAM,SAAS,GAAG,cAAc,CAAC,WAAW,CAAC,CAAC;IAC9C,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,wBAAwB,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;IACjE,CAAC;IACD,OAAO,wBAAwB,SAAS,iBAAiB,CAAC;AAC5D,CAAC","sourcesContent":["export type Environment = 'dev' | 'uat' | 'prod';\n\nconst API_SUBDOMAINS = {\n  dev: 'dev-api',\n  uat: 'uat-api',\n  prod: 'api',\n} as const satisfies Record<Environment, string>;\n\n/**\n * Returns the user-storage API base URL for the given environment.\n *\n * @param environment - The target environment.\n * @returns The base URL for the user-storage API.\n * @throws If the environment is invalid.\n */\nexport function getUserStorageApiUrl(environment: Environment): string {\n  const subdomain = API_SUBDOMAINS[environment];\n  if (!subdomain) {\n    throw new Error(`Invalid environment: ${String(environment)}`);\n  }\n  return `https://user-storage.${subdomain}.cx.metamask.io`;\n}\n"]}

package/dist/index.cjs

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getUserStorageApiUrl = exports.AuthenticatedUserStorageService = exports.getAuthenticatedStorageUrl = void 0;
+var authenticated_user_storage_1 = require("./authenticated-user-storage.cjs");
+Object.defineProperty(exports, "getAuthenticatedStorageUrl", { enumerable: true, get: function () { return authenticated_user_storage_1.getAuthenticatedStorageUrl; } });
+Object.defineProperty(exports, "AuthenticatedUserStorageService", { enumerable: true, get: function () { return authenticated_user_storage_1.AuthenticatedUserStorageService; } });
+var env_1 = require("./env.cjs");
+Object.defineProperty(exports, "getUserStorageApiUrl", { enumerable: true, get: function () { return env_1.getUserStorageApiUrl; } });
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,+EAGsC;AAFpC,wIAAA,0BAA0B,OAAA;AAC1B,6IAAA,+BAA+B,OAAA;AAiBjC,iCAA6C;AAApC,2GAAA,oBAAoB,OAAA","sourcesContent":["export {\n  getAuthenticatedStorageUrl,\n  AuthenticatedUserStorageService,\n} from './authenticated-user-storage';\nexport type {\n  AuthenticatedUserStorageActions,\n  AuthenticatedUserStorageCacheUpdatedEvent,\n  AuthenticatedUserStorageEvents,\n  AuthenticatedUserStorageGranularCacheUpdatedEvent,\n  AuthenticatedUserStorageInvalidateQueriesAction,\n  AuthenticatedUserStorageMessenger,\n} from './authenticated-user-storage';\nexport type {\n  AuthenticatedUserStorageServiceListDelegationsAction,\n  AuthenticatedUserStorageServiceCreateDelegationAction,\n  AuthenticatedUserStorageServiceRevokeDelegationAction,\n  AuthenticatedUserStorageServiceGetNotificationPreferencesAction,\n  AuthenticatedUserStorageServicePutNotificationPreferencesAction,\n} from './authenticated-user-storage-method-action-types';\nexport { getUserStorageApiUrl } from './env';\nexport type { Environment } from './env';\nexport type {\n  Caveat,\n  SignedDelegation,\n  DelegationMetadata,\n  DelegationSubmission,\n  DelegationResponse,\n  WalletActivityAccount,\n  WalletActivityPreference,\n  MarketingPreference,\n  PerpsWatchlistExchange,\n  PerpsWatchlistMarkets,\n  PerpsPreference,\n  SocialAIPreference,\n  NotificationPreferences,\n  ClientType,\n} from './types';\n"]}

package/dist/index.d.cts

@@ -0,0 +1,7 @@
+export { getAuthenticatedStorageUrl, AuthenticatedUserStorageService, } from "./authenticated-user-storage.cjs";
+export type { AuthenticatedUserStorageActions, AuthenticatedUserStorageCacheUpdatedEvent, AuthenticatedUserStorageEvents, AuthenticatedUserStorageGranularCacheUpdatedEvent, AuthenticatedUserStorageInvalidateQueriesAction, AuthenticatedUserStorageMessenger, } from "./authenticated-user-storage.cjs";
+export type { AuthenticatedUserStorageServiceListDelegationsAction, AuthenticatedUserStorageServiceCreateDelegationAction, AuthenticatedUserStorageServiceRevokeDelegationAction, AuthenticatedUserStorageServiceGetNotificationPreferencesAction, AuthenticatedUserStorageServicePutNotificationPreferencesAction, } from "./authenticated-user-storage-method-action-types.cjs";
+export { getUserStorageApiUrl } from "./env.cjs";
+export type { Environment } from "./env.cjs";
+export type { Caveat, SignedDelegation, DelegationMetadata, DelegationSubmission, DelegationResponse, WalletActivityAccount, WalletActivityPreference, MarketingPreference, PerpsWatchlistExchange, PerpsWatchlistMarkets, PerpsPreference, SocialAIPreference, NotificationPreferences, ClientType, } from "./types.cjs";
+//# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,0BAA0B,EAC1B,+BAA+B,GAChC,yCAAqC;AACtC,YAAY,EACV,+BAA+B,EAC/B,yCAAyC,EACzC,8BAA8B,EAC9B,iDAAiD,EACjD,+CAA+C,EAC/C,iCAAiC,GAClC,yCAAqC;AACtC,YAAY,EACV,oDAAoD,EACpD,qDAAqD,EACrD,qDAAqD,EACrD,+DAA+D,EAC/D,+DAA+D,GAChE,6DAAyD;AAC1D,OAAO,EAAE,oBAAoB,EAAE,kBAAc;AAC7C,YAAY,EAAE,WAAW,EAAE,kBAAc;AACzC,YAAY,EACV,MAAM,EACN,gBAAgB,EAChB,kBAAkB,EAClB,oBAAoB,EACpB,kBAAkB,EAClB,qBAAqB,EACrB,wBAAwB,EACxB,mBAAmB,EACnB,sBAAsB,EACtB,qBAAqB,EACrB,eAAe,EACf,kBAAkB,EAClB,uBAAuB,EACvB,UAAU,GACX,oBAAgB"}

package/dist/index.d.mts

@@ -0,0 +1,7 @@
+export { getAuthenticatedStorageUrl, AuthenticatedUserStorageService, } from "./authenticated-user-storage.mjs";
+export type { AuthenticatedUserStorageActions, AuthenticatedUserStorageCacheUpdatedEvent, AuthenticatedUserStorageEvents, AuthenticatedUserStorageGranularCacheUpdatedEvent, AuthenticatedUserStorageInvalidateQueriesAction, AuthenticatedUserStorageMessenger, } from "./authenticated-user-storage.mjs";
+export type { AuthenticatedUserStorageServiceListDelegationsAction, AuthenticatedUserStorageServiceCreateDelegationAction, AuthenticatedUserStorageServiceRevokeDelegationAction, AuthenticatedUserStorageServiceGetNotificationPreferencesAction, AuthenticatedUserStorageServicePutNotificationPreferencesAction, } from "./authenticated-user-storage-method-action-types.mjs";
+export { getUserStorageApiUrl } from "./env.mjs";
+export type { Environment } from "./env.mjs";
+export type { Caveat, SignedDelegation, DelegationMetadata, DelegationSubmission, DelegationResponse, WalletActivityAccount, WalletActivityPreference, MarketingPreference, PerpsWatchlistExchange, PerpsWatchlistMarkets, PerpsPreference, SocialAIPreference, NotificationPreferences, ClientType, } from "./types.mjs";
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,0BAA0B,EAC1B,+BAA+B,GAChC,yCAAqC;AACtC,YAAY,EACV,+BAA+B,EAC/B,yCAAyC,EACzC,8BAA8B,EAC9B,iDAAiD,EACjD,+CAA+C,EAC/C,iCAAiC,GAClC,yCAAqC;AACtC,YAAY,EACV,oDAAoD,EACpD,qDAAqD,EACrD,qDAAqD,EACrD,+DAA+D,EAC/D,+DAA+D,GAChE,6DAAyD;AAC1D,OAAO,EAAE,oBAAoB,EAAE,kBAAc;AAC7C,YAAY,EAAE,WAAW,EAAE,kBAAc;AACzC,YAAY,EACV,MAAM,EACN,gBAAgB,EAChB,kBAAkB,EAClB,oBAAoB,EACpB,kBAAkB,EAClB,qBAAqB,EACrB,wBAAwB,EACxB,mBAAmB,EACnB,sBAAsB,EACtB,qBAAqB,EACrB,eAAe,EACf,kBAAkB,EAClB,uBAAuB,EACvB,UAAU,GACX,oBAAgB"}